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1 INTRODUCTION AND QVERVIEy 



1.1 Purpose of the program pscksi^e 

With the prosSrsm package ADVENTURE EDITOR you own 3 tool for 
working on Adventure ^sdies for the 'Adventure' command module? 
pertaining to the Texas Instruments TI99/4A Home Computer. You 
ma^ wish to - and are able - to investigate in and/or alter all 
existing games as well as to write your own ones* 

This offers all opportunities a 'Tl-adventurer ' has ever dreamed 
of. ' 

1#2 Uhat you need - eouipment 

You received the package accoT»<jirig to your order in one of tuc 
possible versions^ either for the Mini Memory or the Editor 
Assembler command module* Besides the console (TI?7/4Af the 
old one -TI97/4-' does't work) you will need the respective 
commc^nd module and - for Editor/Assembler only - memory 
e;:P3nsion and Disk drive with controller or - for Mini Memory 
only - a suitable Cassette recorder. 

The Adventure command module is NOT necessary but strongly 
recommended Tor testing your new games* 

A printer with its Tl-pe r iphe ra 1 is recommended as wellf but not 
a must. You can print out a full documentation of any game if 
you own one* 

1.3 UJiat you need - knowledge 

You should already have played seme adventure games with th9 

TI?9 before starting to develop your own ones in order to 
understand how it will work. 

Some practical knowledge of any programming language (BASIC or 

the like) will help to understand the concepts and structures 

you will have to deal with in adventure programming. You will 
have to do a good bit of thinking in abstractions. 
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Kriowled:2e of ssseiibl^* lon^us^e or GPL is NOT necessary! 

You csn ONLY virite adventure 23fnes In enalisl^f since the comfrisnd 
jnodule will produce its own (en^lish) messages which ^^ou cannot 
^c?t rid of* 

Uh^ir ^uu siet 

Depending on the version (MM = Mini he:nor*j or EA = Ed i to r/ Assejnb 1 e r ) 
you have received a Cassette in the first esse or a diskette (5 
1/4* S3/SD) in the second case* The software is functionally 
the same in both cases* Since the MM will be used up the last 
b'jie of its 4kB RAM? there will be a lot of room left if '^ou run 
tht2 "EA-version* 

You received two prosrarris and one file in both versions! 

- a* /ADVENTURE EDITOR' 

for Edi t in^/Pr int ini2 Raines 

MM : Cassette side A Program No* 1 
EA : 'DSKl .EDITOR' 

- b* 'ADVENTURE CONVERSION' 

for converting- e:<istini2 Barnes 

MM : Cassette Side A Pro-^ratn No* 2 
EA : 'DSKl *COMVERT' 

- c* 'ADVE?4TURE TEMPLATE' 

as a 33iie template for your own ideas 
MM : Cassette Side B File No. 1 
EA : 'DSKl. TEMPLATE' 



What you can do 

The programs of this package will allow you to : 

- Frei>^r9 e«istin3 ^atnes for the ADVENTURE EDITOR 
usina the ADVENTURE CONVERSION program 

- in both old or new same-s (convertedf if old) 
showf edit or print all te;:ts and lists which 
make out the ^3sie» 

• showf edit or print the logic of the game 
using a new mnemonic language (A*P*L*) 
(both with ADVENTURE EDITOR) 

- load or save games from/to either Cassette 
or Diskette as desired* 

The programCs) will in all cases take care of the internal data 
structures like pointers and tables* You may create a game 
freely without bothering about the internal stuffy entering tej:t 
and structures as you like* 
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1 • 6 How the ^uide is conceived 

There are two tnsin purposes for this reference 2uideJ 

- You will ^et all information needed to under- 
stand the structure of an adventure dame in 
order to create new ones which will react 
properly to the placers coinaiands* 

- You will be advised in usin^ the pro^rarris* 

This results in a detailed description of adventure aaaies with a 
separate chapter on all texts and lists you have to prepare^ 

A second chapter on the ' p rod r sniinins landusde' A»P»L» (which 
tnesns Adventure Prodraniinind Landuadef don't confuse with APL!) 
will describe in detail this interesting tool* You will be 
diven some examples in order to better understand its 
possibilities and to dive you soine ideas to start with. 

You will possibly not understand everything in these chapters if- 
you first read thefiif it is suddested that you skip those lines 
and reread them later on when you will be acquainted with the 
prcdrsms* Most probably the Questions you will ask later on 
will find their answer here* 

The next chapter will introduce you to the EDITOR prodram. Ycu 
will have to learn the mnedionics used for command input when 
usind the prodram* When you have had some trainind you will 
probably skip these lines* 

This is the same for the chapter on usind the CONVERT-p r od r sm . 
One difference may be that ycu will use this prodram very 
rarely? naciely when lookind at your old dames (Pirates Adventure 
or the like) which may be a dood trainind to understand 'how to 
do it'* You will have to convert them before loadind them with 
the EDITOR* For reasons of copyridht these dames are not 
discussed in the reference duide* 

A short chapter on the contents of the dame TEMPLATE will 
prepare you to start with your own dsmes* 
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Some more remarks - technical sod personal - of the author in 
the last chapter of the reference 3uide are intended to make ^ou 
realize the problems and possibilities of adventure p ro^ r a.Tim in^ , 

As *=fOu see this is a whole lot of information* Don't worr-^ 
sOu will set familiar with itf and then it looks like child's 
pl3»i and it is a Play after all? isn't it? So I wish ^dj 

lots of funf and remembert You can clwa^s SAY YQHO 

^ ^ ^ ^ /^C <^ <^ <^ <jc <^ ^ <|c <^ ?^ 3^ <^C >^ <^ <^ ^ <^ <^ /^C ^ ^ #^ <^ ^ 4^ ^ <^ 
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2 STRUCTURE OF AN ADVENTURE GAME 

An Adventure ^ame seeBis to be 3 pseudo-intel 1 i^ent structure when it 
is ussd b^if €f plsyer* This is sccontp 1 i shed by rTie3n3 of the Adventure 
comrftsnd module and seems very different to the ssme programmer. 

Internally 3 ^ame consists of several lists and reference data which 
- interpreted and interconnected by 3 special 'program' - sive the 
effect of an intelligent entity* 

This decription covers all relevant aspects of these lists and data 
in order to enable the same pro-^rammer to achieve the desirod 
rt'Sults* The very complex; internal data structures (mainly pointer 
tables) will not be discussed since the ADVENTURE EDITOR programs 
will manage all this. 

2*1 How to use te;it d^^ta 

Tey.t dat^ maks? out the largest part of such a kind of adventure* 
as everybody who played those 3smos can imagine. Therefore it 
is advisable to Plan your te;:ts in such a way that thewhole 
plot of the 3ame is consistantf and to find interesting and 
surprising solutions for any situation* 

Your te;tt data have to be entered as lists (messasesi obJectSf 
locations^ verbs and nouns) > i#e* te;<ts are ordered and 
nu.Tibered^ Each numbering must be^in with '0' (zero) and soos 
throuSih to the aajcimum number of each list. The number '0' 
(zero) {(lUst exist? althourSh it cannot be used for te::ts in some 
cases. The numberinss must be continous. 

Th3 r9tf»rer\C9 to. any of these texts is achieved by 3ivin^ the 
a»'prcpriste number preceded by the first letter of the list naiie 
(3S a capital). For instance M2 means message *2 - whatever 
t^:is text may be* The player of a 3ame will of course never 2et 
in touch with these numbers? their only purpose is in 
proSranmin^ the 3ame» 

Some numbers have predefined meanings in some cases which will 
be mentioned from case to case. The first element (number 0) 
has to be used with special care» as will be mentioned as well. 
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There is one list for 3II tnesss^ec appearing throughout 
the ^a;ae process* These csn onl'^ be cslled from A.PoL. 
pro^raois and uill never appear sutomsticsl ly ♦ - Don't 
confuse with the built-in luesss^es aiven in several 
situations ('The li^ht has run- out' or the like) which can 
NOT be used fro« A*P,L* 

^MessaSes always appear in the lower part of the screen and 
are meant to describe the aame or to ^ive hints to the 
placer ♦ 

Number 0 (MO) t can be used 
Special Tieanin^s I none 

Objects 

There is one list of te::<ts (nanies) -for all the objects b'ou 
can see and/or manipulate durin*^ the ^ame* These objects 
are managed b^^ automatic actions ( 'Visible ' f ' I ' fii 
car r^in^ ► # ' 'GET' 9 'DROP' etc.) and by your prosraci as 
wel 1 

The object names will 3P?'e3r in the upper or lower part of 
the screen depending on the actions you take. The command 
module will add the ^I'm carrying...' or 'Visible...' 
headers* 

Besides its number and the pertaining text any object 
always has a location where it can found ('Situation'). A 
'Reference' to the nouns is ^iven if it can be 'TAKEn or 
DRCPped' automatically. 

Treasures - if present - must have their name preceded by 
an asterisk ('*')• Everythin-^ else is optional (Capitals^ 
asterisk at the end etc.). The number of treasures that 
eauals 'lOOJI' MUST be siven correctly within the 'general 
informations ' » 
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Nuriiber 0 (00) t csn be ussd 

Special Meanings t 09 

There is 3 special nieanina for object *? (09) : It must 
be us<j4 as a kind of 'lit torch' or the like* The r-fsson 
for this is that there is a counter for this object which 
will be decremented every 'round' when this object (0?) 
exists somewhere in the Same* When this counter ('Torch 
counter') will reach zerof the well known messages 'The 
light runs out in turns' or 'The iisht has run out' 

will appear automatically and cannot be suppressed. 
Therefore if you have to use this object for seme other 
purpose be aware of this effect and initialize the 'torch 
counter' with a very lar^e number (see 'General 
information ' ) • 

2*1.3 Locations 

All locations you can reach inside the same have their 
name in this list. Locations can be treated 
'automatically' (by giving directions which must 
correspond to a list of 'Connections') or can be changed 
by A»P»L» Program statemements if you wish to. 

A location within the adventure same is identified by its 
number and appears to player cs a short tertt. There is 
one 'actual location' - a number defining a location where 
the 'player PUPpet' is? and each object has sot its 
'location' defining where it can be found. There is one 
'Starting location' and one 'Score location' - both 
defined in the 'general informations' 

T^le location names will always appear at the top of the 
screen ('I'm in a*..')* If you don't want this automatic 
header to appear besin the location name with an asterisk 
('«')• In that case you must sive the complete te^t 
<*tl^n^ at the beach')* The asterisk will not be printed! 

Number 0 (L0> : DON'T USE 

Special meanings I last location in the list 
This location • the last element of the list independent 
of its actual number! - has the meaning of 'End of the 
game't Whenever you reach this place the screen colcur 
switches to white/red. The same is not over howe'/er: 
Have you ever tried SAY YOHO in Pirate's Adventure when 
you're 'in Never Never Land' ?? This can be accomplished 
by taking actions in A.P.L. since only the A.P^L* 
command 'lOver'-will really end the game* 
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2.2 ^'ccsbular^^ 

You csn only 3ive your comnisnds during the 33me usin^ two word 
en^lish sentences. Let's define the first word as 2 'verb' sn'l 
the second one - if it e^cists - 3S 3 'noun'. This results in 
UITH bein^ 3 verb (UITH HAND) or NICE being 3 noun (LOOK NICE)- 

Uhenever you 5ive 3 command the commsnd module searches the 
'vujrb' list for the first word. If it doesn't find it (snd it 
isn't 3 direction or D^it gives the .Ttessai^e 'I don't know how 
to something' f otherwise it stores the number. The ssiiie is 

the done with the second word 3nd the 'nouns' listf the .nesss^e 
being of course site red to 'I don't know what 3 ... is'. If 
there is no second word (LOOKfLISTen etc.) actions are taken as 
ncrn^l. Ycu csn however construct A.P.L. program Lines which 
will react to this 3S well. 

The number of characters for abbreviations (see 'general 
information') will result in lists of verbs and nouns of th.it 
lengtii* It's UP to you to make abbreviations uniaue. If words 
are shorter thsn this leng^th (GO etc.) enter only the full 
word* In all other cases enter the abbreviation (DRO or DROP 
depending on 3 or 4 characters for abbreviations!) 

For eouivalent words - i»e. words which will behave ejtactl-^ 
like others - enter these equivalents immediately following the 
'msin' word snd place 3n 3sterisk 't^ at the beginning. This 
chsracter must of course NGT be entered 3S 3 command? it Just 
serves the purpose of designating synonyms. In programming only 
refer to the 'main' word? the duplicates are invisible to any 
reference . 

2*2.1 Verb<5 

Verbs - the first words of the two-word commands - are 
used to select one special 'block' of A.P.L. lines? 
leading to the desired effects if you construct these 
lines accordingly. The number of the verb in its lict is 
the number of the block selected. (Don't use synonyms as 
block numbers! They will never be e^cecuted.) 
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Na;ribar 0 (NO) : DONT'T USE 

Special meanings : Vl = GO or the like 

VIO = TAKE or the like 

U13 = DROP or the like 

2.2*2 Nouns 

Nouns - the second uords of the two-word conmands - are 
used to select one or more lines within the block of 
A»P»L» )='ro^rani lines to be executed* You cen take the 
actions ^rfou want to in these linesr depending on the 
comniand* It is possible to write lines for ari':^ noun 
( especiall*:* useful if no noun was ^iven)» 



Number 0 (NO) 


: DONT 


'T USE 




• 












: Nl 


= NORT 


( North 


f for GO 


NORT 
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} 




N2 


= SOUT 


( South 


f for GO 


SOUT 




c 


) 




N3 


= EAST 


(E3St 


f for GO 


EAST 
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) 




N4 


= WEST 


(West 


; for GO 


UEST 










NS 


= UP 


(Up 


f for GO 


UP 




U 


) 




N6 


= DOUN 


( Down 


• for GO 


DOUN 




D 


) 




N17 


= INVE 


















( Inventory 5 


for TAKE 


INVE 




I 


) 



Since nouns often refer to objects (mentioned above) there 
is 3 list of references (for ever^ object; which noun? if 
one ?)• This list is onl-^^ needed for 'automatic' 
TAKE/DROP actions- 

2*3 Cross references 

Some t'^pes of lists mentioned earlier are needed to Sive all 
necessary* information for the 3ame ♦ 

2.3*1 References 

As mentioned .^bove a reference has to be 3iven in order to 
accomplish 'automatic' TAKE/DROP actions* So if ':<ou 3ive 
a noun the module locks up in this list what objects ^ou 
could have meant and takes the actions needed. It is 
possible to access several objects with the same noun: 
The first object that fits will be used* 
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It should be noted that all actions '^ou take within the 
A»P»L can NOT make use of this tacle^ You have to check 
for the existence of an^ object ^ou want to refer to* 

So if for exatn/^le you 2ive the command TAKE (N15) or DROP 
vNlS) the command module will first check what objects can 
be referred to b^:* N15o If there is (at least) one of 
them? it checks whether or not the placer is carr'^in^ it 
or if it is visible^ respectively* If he hasn't 2ot too 
much to carry (if TAKE is entered) the appropriate 

actions are taken. So in this process the following 
'automatic' messages could occur: 

'I'm not carrying it' (DROP) 
'I already have it' (TAKE) 
'I don't see it here' (TAKE) 
'I've i^ot too much to carry' (TAKE) 
'It's beyond my power ta do that' 
(No reference found !!) 

Note* Special care has to be taken in your A*r*L» 
program in order to let this work properly! 

2.3»2 Situation 

As mentioned above there is a location for every object at 
any time* Since this List will vary very much during the 
^ame it is simply called*, 'situation'* There are by the 
way two lists which are identical at the bedinnin^ of the 
playt one of them will be altered during the ^aiT:ef 
whereas the other one will be used to initialize the 
situation after a slame restart or at the beiiinnin^* It 
also serves for special A*P*L* statements checking 
whether or not an object has moved from its starting 
position. Note that you can enter only one list - the 
starting situation* 

In the 'situation' table LO has the special meaning of 
'doesn'^t (yet) exist'* Furthermore an object can be 
'Carried' which is also a valid location* All locations 
3iven are of course the starting locations for any object 
which will be altered during the ^ame* 
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You h3v© to define in which wa^ the locations are 
connected means of 'obvious e:cits'» If this is done 

^ou can 'GO' there bv^ entering the direction* 

This list consists of six: location numbers in the 
follouJini;i order: North(NORT) - South"(SQUT) - Esst(EA£T) - 
Uest(UEST) - Up{UP) - Dcwn(DOUN)» If there is no 
connection in one direction* enter LO at that Place* 
Don't confuse the player by Sivina connections uhich won't 
return him to his starting place when usma the reverse 
directions unless you want to reach special effects (a 
maze for instance) • 

E;<3fnple : Location *1 (LI) : LO L2 L4 LO L5 L6 mesns 
Froifi LI SOUTH is L2 f EAST is L4 r UP is L3 ? DOUN is Li 

2.3.4 General Information 

Some information which doesn't make up a list is fathered 
here* They are preceded by the neutral 't'-si^n to 
indicate numerical values* 

• Number of objects you can cBrvj* 
This value is checked for 'automatic' 
TAKE/DROF actions and can be checked 
(optional) when picking up objects in 
your A»P*L* program* 

Error message I 

'I've ^ot too much to carry*' 

- Starting location* Location number where 
the player will start the 3ame* 

- Mumber of treasures that make out 'lOO'i'* 
Remember that the same is over for d Score 
100%! If you enter '0' (zero) here> don't 
use treasures! (and vice versa) 

• Length of abbreviations (3 or 4 in the most 
casesf ma^c* value is ?!) 

- 'Torch counter' starting value* 

This is a value of 2 byte len^thf max. 32767* 
For calculating the total multiply the first 
value (byte) by 236 and add the second one. 
If you don't use a lamp at all> enter 32767 
(»127 *253^127x2S6f 233^32767) 

- Score Location. Location number to father your 
treasures (Remember^ Objects be^innina with '*')♦ 
Uhen th'* statement ! 'Score is executed? the 
number of treasures in this location is checked. 
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2. -J Interne;!^ 

Some information v^ithin the ^sme which is 'save'd and 'load'ed 
is not obvious to the player. This information is ffieaninsful 
onl'^ to the A»P.L» programmer if he decides to use it. It 
cannot be 'printed' or 'listed' since it ejcists onl^ as an 
abstract idea. This background inf onnation makes the :2ame seem 
'clever' or 'witt'j' however? increasin:^ the Jo^ of the pla^r^er, 

2.4.1 Flaj^s C F ) 

You can use Bit-fla^s (set/reset or ouery) to indicate 
certain ^amo states or to initialize certain actions, 
Fla^s are alwa*:rfs initialized with '0' (reset) at the 
be^innxn^ or restart of a aanie. 

You can use 32 fla^s (FO through F31)f with predefined 
meanings for FIS and Ftc, 

FIS has the meaning of ' ( da*^- ) 1 i 5ht ' (reset) or 
'ni^ht/dark' (set) which will result in the screen colours 
black/^reen for 'li^ht' or white/blue for 'dark'. If it's 
'dark' (F13 Set) the command module will no longer displa'j 
an^thin^ visible* This will be . over ridden b^ a visible or 
carried 0? if the 'torch counter' has not '^et reached 
zerof which means that a 'lit torch' will illuminate the 
surrounding* This must be considered in the case that 09" 
is MOT used with that sp^fcial meaning! 

F16 is set by the command module if during the ^ame the 
'Lit torch' (which is 09) has run out of fuel (torch 
counter is zero). You can then take the appropriate 
actions* Have in mind the effect's described above! 

2.4.2 Counter ( ♦ ) 

You can use counters in the :3ame to count anything you 
want to, AIL calculations are dene with a 'current 
counter' which can be manipulated (display? addf subtract? 
setf compare) within the A*P,L, ♦ The value of any of 
the counters may be from -32763 to +32767; the 
calculation constants within the A,P,L, may however only 
be positive values from 0 to 253! This may result in some 
problems but cannot be altered. 
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You csn slso exchsn^e the 'current counter' with one of 
the siK 'stored counters' »0 to *5» Note that thess 
cannot be initialized Bt startup? ^ou will have tc 
initialize them yourself with an appropriate A^P»L» 
construction if this is necessary* It is however not 
possible to compare the value of two counters* 

Don't confuse these counters with the 'torch counter' 
mentioned before which is under total control of the 
ccoiiTiand modu 1 e ! 

2.4*3 Locations stored 

You can store up to seven Locations LO through L6 which 
will be 'save'd and 'load'ed with the aatne^ Ycu c.3n 
ejtchan^e them with the 'current location' any titne you 
like Prom A.P^L* • The purpose of this is not so obvir'js 
but cari be used by clever proirainmers tc achieve special 
resul 1 3 * 

Don't confijs thetii with the locaticris iri the list! LO tc 
L& can mean one cf the stored locations OR one of the list 
elements deperidin:^ on the A*P»L* statement* 

2*3 Entry screen 

Th? entry screen appearing at initial startup is not of a bi^ 
iir.portance to the same. It serves however as an introduction to 
tl^e Hlot and for copyright notes^ so that it can be entered 
here. Note that the last two lines are reserved for the Editor 
Copyright snd cannot be altered. 

2.A Adventure Prosrammins Lanalua^e - A.P.L* 

A detailed description of this interesting ' p r c^ r a rii.T: i ni 
lan^ua-^e' will follow in the ne;it chapter of the reference 
^uide. Here are some General remarks^ 

The losiic of the same is written and storv^d in intermediate 
IsnSussie which has to interpreted during the same. This simple 
IsnSuaSe designed for adventure prosrammins is part of the 
adventure command module. To make it readable short mnemonics 
were developed which are very close to the actual meanins* Notsi 
that these mnemonics have not been found in the command module 
buL are part of the ED ITOR-P ros r am which will convert it to tha 
tuken-z for tlie adventure same. 
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Lsrr^ijs^e s t ructu re 

The msin elements of this Isri2u3:2e areJ 

A) Conditional Ststements 

B) Actions ( conseouencs ) 

C) Logical Statements 
(ir^ELSEfRET'uRN) 

The proi^rsfTi ^ou write is divided in "blocks' y each block 
consisting of 'lines' • This means that a block is first 
selected? and then all lines are checked for 'validit*^' 
and ey.ecutedf if valid. This continues until the 'block 
er;d' condition is fulfilled* Only one block cf lines can 
be e^tecuted at a time* 

Each block is selected b^ a 'verb' (e;tce?>ticn block 0)» 
Each line owns a 'validity' header indiC2tin2 the- 
conditions for an e:tecutian of this line. If valid the 
statements of this line are executed one by one until a 
! RETURN is encountered or one one of the block ending 
statements (lOver? ! 'Score 10071) is ejcecuted. 

The validity header* is the number of rioun or zero in all 
blocks but block zerof and a probability from 0 to 100 in 
block zero* 

Within a line you can use nested IF (THEN)/ELSE structures 
to a level of si^w Be cautious in usin^ IF uithout a 
condition! 

Uhat you can NOT do in A»P#L» is - compared to BASIC - 

• Jumps 

• Subroutines 

• REMs 

- DATA Statements 

• Variables 

• and so on 
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2»6»2 continuous actions 

Block *0 is executed ^utometicsl 1^ each time vou enter 3 
command after checking your command in,'='Ut» So in this 
program block you will place all actions that have to be 
e:;ecuted without regard to the actual command* 

The ' vel idi ty ' -header at the be^innin^ of each line means 
3 probability from 0 to 100 i7.) 9 so that lines can be 
executed not every step. The internal RND function is 
used for this purpose. 

Uithin block 0 all lines are executed (with their 
respective probability)? this means that the only 'block 
endin;2 conditions' are the execution of the statements 
'!Qver' or '! 'Score' with 3 result of lOO::. 

2»6»3commar'id dependant actions 

All oth!?r blocks are executed depending on the number in 
the 'verb'-list» Remember that only 'main' verbsf no 
synonyms can have A#P»L» blocks! The EDITOR does not 
allow to build a block for such verbs? but you can trick 
him out by altering the verb list later on* 

The 'validity' header for each line is a 'noun' number 
(without H\) 50 that a line is ex.ecuted for a well 
defined combination of verb and noun? that is for one 
'ccmmand'* You can have several lines for one commanot 
but only one can be totallj executed* 

The 'block ending condition' for these blocks is the 
'successful completion' of a line* This can bet 

- a ! RETURN 

- 3 ! 'Carry which is NOT executed (!!) 

• a Statem.fnt '!Over' or '! 'Score' (100%) 

A header of zero indicates a line which will be executed 
regardless of the noun ^iven (especially no noun at all) 
so that you can use verbs intransitively. 
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If v^ou combine ncun-nutnbe rs and the nunnber zero? be aware 
of the effect that an^ 'succefully completed' line ends 
the block! Therefore you will place those lines at the 
end of the block in most esses* 



2o7 Actions taken b\^ the command module 

There is some ' intel 1 ia'ence ' built in the command module which 
exceeds interpreting you A»P»L* program* This will result in 
'aijtomstic' actions in most cases> together with the appropriate 
messages* 

You must be aware of this when writing your program* A 
'seauence schedule' will be given ^t the end of this chapter 
which will explain in detail all possible combinations. Use 
that schedule whenever in doubt about the actions! 



2*7»1 Directions 

Directions can be entered as a single letter command or as 
GO (Direction) % The command module will accept that and 
take the appropriate actions* The r;iessa:3es 'Please give 
me a direction also' 9 'It's dangerous to move in the 
dsrk' or 'I Pell down and broke my neck' may result from 
this. 

The list of 'connections' serves as a 'map' for these 
actions* 

If 'GO' is used with some other noun however you must care 
for all necessary actions in A.P.L. Block 1 yourself. 

2.7.2 automatic TAKE/DROP 



The automatic TAKE/DROP actions have been discussed 
earlier.. Since these actions are taken AFTER completing 
the A*P*L. blocks some special effects have to be 
considered • 
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The condition for the automatic TAKE/DROP action is that 
this ver^ action has not been tried/and or ccfTjpletec m 
the A.P^L» block* If ans one line (for that noun) has 
onl'^ been besun no further actions will be taken! In that 
case - if not yet successful - the built-in messase 'I 
can't do that yet' will appear and nothing vjill happen. 



Li^ht 

As mentioned above you can determine whether it is 'li2ht' 
or 'dark' by resettina/sett ins FIS (Fla<i IS). The 
consectuences of this are obvious. Keep in mind however 
that this rlaii is doruinated b'=; the 'lit torch' 0?: If 
this object is carried or visible? it will be li^ht even 
thoui^h FIS is setf in case that the 'torch counter' has 
riot yet reached zero. 



Furthermore a 'lit torch' or the like is managed by the 
comr.iand module and will result in the messages 'The Iisiht 
runs out in turns' or 'The li^ht has run out'» if 

necessary* You cannot suppress these messa^esf but you 
can ask if the lamp is still lit (F16 Set). Otherwise it 
is UP to you to take the actions required (let the 'torch' 
vanish or some other effect you have in mind)* 

2.7*4 The End of the 2a mo 



player is ' d e 3 d ' you c a ri use the built-in f e s t u r e 
of the 'white/ red' screen by putting him in the last 
location. The cotwmand module will then switch the colors. 
This can be achieved by ercecutins the command '!I'm Dead' 
in A . P . L * 

This is however not the End of the samet The play csn lo 
on as normalf if you decide to let him out of 'limbo' in 
some way . 

The real and immediate end of the same is achieved by 
executing the A*?.L* statement '!Over' * This will 
result in the message 'want to play this adventure assin?' 
with all possible consequences. 
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The scrsen color and other actions depend on two fla^s 
that you can set (but not reset) from A»P»L I 

- Fl3^ Dead t will switch to white/red. 

- Fla^ Uell done : will switch to black/yel low ♦ 

Note that the same effects as with '!Over' can be 
accomplished when the statement ''.'Score' is e;:ecuted witli 
3 result of lOOZ ! 

Gvsme seauence schedule 

A ^ame is a cyclic f=^rocess which is passed through every 
tiiTie a command is entered* A ^raf ical description helps 
best to understand how it works* 

Possible messa:2GS are indicated by a (:;) and mean: 

(a) 'I don't know how to something' 

<b) 'I don't know what a is' 

(c) 'The li^ht runs out in turns' 

<d) 'The liiSht has run out' 

(e) 'Please ^ive me a direction also' 

<f) 'I can't ^o in that direction' 

(S) '^It's dangerous to move in the dark' 

(h) 'I fell down and broke my neck' 

<i) 'I can't do that yet' 

(J) 'It's beyond my power to do that' 

(k) 'I'm not carrying it' 

(1) 'I don't se^ it here' 

(m) 'I already have it' 

(n) 'I've ^ut too much to carry' 

(o) 'I don't understand your command' 
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t Prosram stsrt 

* ============= 

« I 

* Entry screen 
t I 

« +-< 

« I 

t Initial irstion of 

* Fl3^s>Situ3tion etc. 
t I 

« +-< 

t I 

« +-< — Over Block 0 - A.P.L. 

* I I 

« I show Locstion/Ob Jects 

t I I 

* I +-< -i- 

* I I I 
« I 'Uhst shall I do?' (s)Co) 

* r I I 

* I Check vefb/noun Error — >- + 

« I I ■ 

« I count 0? (c)(ci) 

« I I 

t I (60>N/S/EyU/U/D QK--(3)-- 

« I I- lError 

* r I + (9) Cf ) (h')--; -■ 

« I I 

* I Block A.P.L. 

* +-< — !--Over corr.verb RETURN : 

* I I 

* I Any one line 

* I besun? Yes — (i )-->-■ 

« I I 

* I TAKE/DROP ? Mo (o) — 

t I I 

» I TAKE/DROP S'jtoti.ot. OK ;: -• 

* I I 

» I + Error — ( J ) ( k ) — >• 

« I ( 1 ) ( J. ) ( n ) 

+ >_ + 

t I 

* pl3y 32sin ? Yes 

t I 

* Prosrsm End 

* =========== 
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3 ADVENTURE PROGRAMMING LANGUAGE 'A»P.L' 

The ' p ro3 rsmiTiina Isnsus^e' A»P»L* (Adventure P po;2 pamrriin^ LsntSus ^9 ; 
- don't confuse with APLi a mathematically oriented hi^n level 
language - is a speciality of the Adventure corrimand module. 

Internally tokens - i»s» a byte code - are used to represent the 
comniands in a similar way like in BASIC. Since these tokens are 
very confusing they will have to be translated to 'mnemonics' in 
order to make them readable* This has been done for the EDITOR 
program so that you can read and enter A.P.L. programs ouite 
st rai^htf orward ♦ - Most of the mnemonics will have to be completed 
by £ddir:;2 one or two ' pa r amete r i ' . 

I\nowled:2e of A#P.L» was fathered in analyzing the built-in A.P.L. 
interpreter so that everything should work fine. It must however be 
stressed that there are some faults and mistakes within the 
Adventure command module which make, programming somewhat confusinsSr 
especislly when using IF/ELSE constructions. 

Since A.P^^L is a lan-Juaae designed specially for adventure Barnes it 
can in no way be compared to any other e:tistiri:2 Iani2u32e. You will 
simply have to learn and accept, it as given. 
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It h3s been mentioned before that the 
prc3irDrt is 'blocks' snd 'lines' • 
clesriy enou^lil 

Block 0 : + 



structure 
A dissrs.n 



of an A.P.L* 
will show thi^2 



Block 1 



Blr3c:; Z 



ILine 
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f 1 ) 




I L i n 5 
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ILine 
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ILine 


(0 


»4 ) 




ILine 


(0 


»3) 





I 

+ — 
+ — 



ctd. 
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( 1 1 1 ) 
( 1»2) 
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ILine 
ILine 
ILine 
ILine 
I ctd. 

^ 

<N=Noun 

J. . 

ILine (S»l) HI 
ILine (5f2) Nt 
ILine (Sf3) Nt 
I ctd» 

+ 

(N = NGijn t) 

There sre no blocks for verbs 2^3 and 4 in 
As can be seen it is possible to write b 
nusibers of lines and to write lines with 
(ni.iJTibar of stat ement s ) • The order of 1 
noriially of some importance for correct pro^ 
is however determined at execution ti.Tie 
executed by checking the 'header' vslue of e 
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3»1.1 Black to - ccntinuous actions 



Tasks 

Block *0 is sKecuted once every round of the pla^ so 
that -liou should program here all the actions which must 
hdP>S'en independently of a command* 

3*1»1»2 Probability values 

The 'header' of each line is a number from 0 through 
100 indicating the p robab i 1 i t*;^ (in 7.) with which this 
special line will be executed* A value of 0 (zero) 
will result in no execution at all! 

3»ltl.3 Ordering of lines 

There is no definition as to the order in which you 
arran'^ie you lines in this block • You must however 
consider the logical interconnections which may result 
in a well-defined ordering of your program lines. For 
instance if you use a fla^ be sure to have set or reset 
it before! 

3»1»1»4 Finishing a line 

You can end the execution of one line by executin:^ the 
statement ' [RETURN' • The next line will then be 
executed with its respective probability* The same 
effect will result from executmi^ '! 'Carry Ox' when 
this action results in an error! 

!Over and ! 'Score ilOOZ) will even stop the execution 
of the block and end the ^ame* 
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3»1#2 Block *1 ff - co(iifn2rid-ini t i 3ted actions 

The Block * is the number of 3n e;tistin2 verb which lia^ 
not be an ' e<:^uiv3lent ' verb (indicated b^ an asterisk 
at its be^innin^) • There must not eicist another verb with 
the same 'abbreviation' <the first four or so letters^ 
since in that case the second occurence would never' be 
dc? tected . 

3.1^2ol Tasks 

Since the lines in these blocks will be e^cecuted 
depending on the coinnand Siven 'dou will pro-^rar.\ the 
corresponding actions here* P3v# special attention to 3 
correct relation to block *0. 

3»1»2.2 Noun 

The 'header' of each lirie repress rits the nuniber of a 
noun from the noun listf or it is 0 (zerc)^ In the 
latter case this line will be executed independent 1 of 
the noun aiven? i»e» it is alws'^s e::ecut2d» 
Tlierefore such lines will be found - if the^^ are used 
at all - at the end of a blocks In all other 'cases the 
line is executed if the noun :3iven (onl*^ the 'nnain' 
noun f not the synonym numbers!) corresponds to the 
line header value* 

It is possible to use the same header value seve^^al 
times in one block* Be houever aware that an*:^ line 
which executes ' successful 1 'd ' ends the er.ecution of the 
block! 

Z^1^2*Z Ordering of lines 

Asain the only restriction is that the results should 
make some sense* 
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3»l#2t4 Finishing a line 

This will be the same as in Block »0 e;ccept thst the 
next line will not in all cases be executed^ 

An^rf line will be executed either 'successfully' or 'not 
successfully'? in the first case the execution of the 
block will be terminated* The execution of the 
statements '!Over' or ' ! 'Score' (lOOi:) will immediately 
end the ^ame* 

The only way to end a line 'not successfully' is by 
executinii a condition which is not fulfilled UITHGUT 
having passed an ! IF-s tatement in that line before. It 
is however important for the 'automatic TAKE/DRQP' 
action whether any one line has even besun executing? 
in that case that action will NOT be started and tha 
niesss:3e 'I can't do that yet' will appear if the line 
operated 'not successful ly ' ♦ 

3*2 A#P»L» Syntax 

All A*P»L* Statements are ^iven in both a lon^ and short 
version* The short version serves mainly for fast entering of 
lines whereas the lon^ version will - if possible - be displayed 
for sake of clarity* 

T^le short version is - in most cases - the lon^ version stripped 
of all blanks and non-capital letters* 

It may happen that lines are too lon:^ to show them on one screen 
if the lonai version is used* In these cases the short version 
is used if in 'edit'-mode so that subsequent editin:^ and 
reentering is possible* In 'print'-mode however the lon^i 
version will be used and the screen will be divided in several 
subseauent screens till the end is reached* 

A*?.L* statements ALWAYS be^in with either an '!' or an 
'?'-si^n which MUST be present? the auest ion-ma rk 
designates conditional statements whereas the exclamation-mark 
'!' is used for logical statements (including !IF) and for 
actions # 
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As fsr ss rs'S rame ts rs (riumbers) are used in the followir::^ 1:3*3 

these are meant as examples only* The nuaibers 7 arid 3 were used 

for indication of list elenients and flass? the number 3 for 

'stored valuiis' and the number as a numeric value* 

In reality you will have to care for a correct use of these 
nu(T;bers# For instance if you use (iiessa^e t6Z) uitnout 

defining M65 the surprising results are up to you»». 

3»2»1 Conditional statements ( ? ) 

Conditions are raised at the moment they are e>:ecuted snd 
can either be fulfilled or not* Since a seGuentisl 
eiiecution of conditions eouals logically ANDin^ them? you 
cannot mcke use of an OR or other logical connections. 

If any one condition is NOT fulfilled program e.'tec'jtion 
uill continue at the ! ELSE co r r espond i nsi to the [ 
statement e;tecuted last* (!!!) If no !IF h^s been 
encountered this means 'end of th*? line (not successful?' 

3*2.2 Actions (!) 

Action statements will result in their respecti/e 
conseauences as soon as they are ercecuted. This may altar 
subseauent conditional statements! 

The actions may be very different depending on the 
stcte-ment? see lists below^ 

3*2.3 Lo'iiical statci me nt^ 

LosSical statements serve for structuring within one lirie. 
It is not possible to branch from one line to another. 
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3.2,3»1 ! IF/IELSE 

You can use IF-st ructures up to a level of si:: (6). 
Display usina the 'lonS' version will indent the levels 
appropriately* 

If any one !IF statement has been e;:ecuted any 

subseauent false condition will result in a branch to 

the pertaining ! ELSE statement - even if this statement 

is BEFORE the condition that raised the fault! Keep 

this in mind clearlyy since you can easily program 

loops that way which can end the ^ame. The IF/ELSE 
differs from the BASIC version ! ! ! 



You can however make use 
programming carefully* As 



of this effect when 
a !3eneral rule yo«j csri say 



any condition of that kind mu: 



that 

time when e^^ecuted over and over a^ain 
loop will be endless* See the examples 
end of this chapter* 



be fulfilled soma 
Otherwise the 
3iven at the 



3 V 2. 3*2 ! RETURN 

A IRETURN somewhere within the line results in 
immediate termination ('successful')* - Whenever an 
!IF is MOT followed by a IRETURN e;:ecution will 
continue after the ! ELSE statement? only by means of a 
IRETURN you can cancel execution* Keep in mind that a 
'! 'Carry O):' which results in the messaiSe 'I've sot too 
much to carry' acts e:<actly like a IRETURN. 

• 4 Statements usin:^ objects 



lori^ version 



short description 



TCarry 07 
TNot Carry 07 
?Visible 07 
?Not Visible 07 
?Carry Visible 07 



?Car ry 
?Not Carry 
?07 

?Not 07 
?E;cchansLe 07 



?C07 

?NC07 

?V07 

?NV07 

?CV07 



?Not Carry Visible 07 ?NCV07 



?C 

?NC 
707 
?M07 
?E07 



Do I car 
Don't I 
Is 07 vi 
Isn't 07 
Do I car 
is 07 vi 
Don't I 
isn't 07 
Do I car 
Do I car 
Is 07 e;: 
Isn't 07 
Has 07 b 
from its 



ry 07 ? 
carry 07? 
sible? 

visible? 
ry 07 or 
sible? 

carry 07 and 

visible? 
ry anything? 
ry nothing? 
istins somewh 

e;tistin5 ? 
een removed 

starting • 
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the 'Situ5tion'-list^ 



?Not EMChan^e 07 




?NE07 


Is 07 at its s t a r 1 1 ri s 








locatiori ? 


! C3 r 07 




1 o ^ 


Carr'ti 07 without check 


! Carry 07 




! CO/ 


Carry 07 and cneck for 








ivi a i n u n u fTi b e r . 








NOTEt This fria's react 








like a '.RETURN in C3Sr 








of error! 


IVisible 07 




! y07 


Put 07 to the current 








location. 


!Not 07 




! NO 7 


L ^ t 07 * a n i s h • 


- 






i •e* : to LO! 


!07 to L3 




! 07L3 


Put 07 at loc^ L3 


! 07 to 03 




! 0708 


Put 07 to the loc 2 tic ri 








w in ere 03 is TjCw. 


! Exchange 07 and 


03 


! E0703 


E^chande the current 








locatioris of 07 2nd 03. 


Statements usina 


loc 


s t i 0 n 3 




Ion 5 version 




short 


description 


?L7 




?L7 


Ani I at location L7 ncu'^ 


?Not L7 




?NL7 


A(Ti I not at L7 now'!' 


!07 to L3 




! 07L3 


Put 07 at loc. L3 


!L7 




!L7 


Goto locatiori L7 


!E>'»chan2e L3 




! EL3 


E;:ch3n5e the current 








loc2tiori with 'scored 








location t3 ' 


The last statenient 


ref 9 rs 


to the 'stored locstiorts' 


meaning of which 


wil 


1 !?e dsfirie<i t>y the asme prcsrani 


note: L3 is NOT 


L3 


of the li 


St ! ! 


Keep in tninrl that 


this St 


a t e rrt e n t e )t c h a n 2 e s (2nd 


dupl ic3tt2s) the 


two 


values of 


current location srid 'st 



location ' • 
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Statements with counters 



lon^ version 


sho rt 


description 


?*9 


?*9 


Is the c. eo'jsl to 9? 


?>*9 


?>*9 


Is the c. arester thsn 9 


?Not >#9 


?N>*9 


Is the c. not 3r. thsn 9 


! #9 


!*9 


Set c. value to 9 


!+t9 


!+*9 


Increment c. by 9 


! -*9 


! -♦9 


Decrement c. by 9 


!Displ3M # 


!D* 


Disflsy counter (+/-!) 


! E;;chan^e t3 


!E*3 


E;:chan2e current counter 



with stored counter t3 



The Isst st3te:ftent refers to one of the 'stored counters' 
whereas all the other work with the current counter. The 
numeric values ran^e from 0 to 235^ whereas the counter 
value may be between -32763 and t32767» This means that 
you cannot check for negative values of any counter! 



Note that the last statement will result in extchanainii 
(not duplicating) the current and the stored counter! 

Statements with fla^s 



lona 


ve rsion 


sho rt 


description 


?F7 




?F7 


Is F7 set (=1)? 


?Not 


F7 


?NF7 


Is F7 reset (=0)? 


!F7 




!F7 


Set Flsii 7 to 1 


!Not 


F7 


•NF7 


Reset Fls-3 7 to 0 




Inventory 


\fl 


Set Fl33 for the auto- 








matic 'Inventory' 






!N/fl 


(upp-er half of screen!) 


!Not 


Inventory 


Reset Fls3 'Inventory' 




Dead 


!FD 


Set Fl32 'Dead' for 








' ! Over' 


!Fla2 


Uell Done 


! FUD 


Set Flaa 'successful' 








for ' ! Ove r ' 



Mote that only the first 4 statements work with the 
user-defined fla^s *0 to t31 which include F15/F16 for thG 
'li^ht' operation* All other fla^s are internal and will 
have effects on the screen display. 
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3.2.8 Statements involving 'inecros' 



3.2.? 



luria version 


5 n o r u 






: ^ tn L' e e Q 


1 T ' ft 


oeXr wo issL iocsiiori 








I' I a p i 3 y L 3 r r y 1 n 2 ♦ ♦ * 








in the lower scree ri 




! uo r P ^ U / 




L3rry u/ cnc cnecK 








for ni3;c i .TiufTi 5 this ;t: sy 








result in ! RETURN and 








'too much to carry ^ 




Unit 0? 


! 10? 


Carry 'Lit tcrch' and 








i fj i 1 1 a 1 i z e torch count 


e r 


! oco re 


! w 


SCO ref atr a score or 








^ f\rw — 1 n w o r i i 
X J \j /• I u V e r I ! 




! S3 ve G sine 


1 c n. 

! wU 


3 3ve uSfTie et,c^ 




! U3it 


! U 


wai* cpp» sec 




! Ove r . 


! 0 


E ri d of t r. e ^ a mi e 




S 1 3 1 e (Ti e n t s i r. 


o 1 V i n s d i s p 1 s y 






•lona version 


short 


description 




!M7 


! M7 


Display Message h7 




! ' Invento ry 


! ' I 


Display 'Carryir»2»».' 








ifi the lower scree ri 




IDisplsy Visible ! DV 


Redisplay upper screen 




!DiSPl3':^ * 


! 


Display counter vslue 




! Displsy Noun 


! DM 


Display N o u n Jus t 








eri 1 9 r e d 




IDispla*^' Noun 


and Scroll ! DN3 


ditto? new lirie 




IScroll 


! S 


ri e w 1 i ri e 




I ri V e ri 1 0 r *^ 3 1 w s 


y s .7! e o ri s the 'I' 


ill carryifj^ displ = 


y ♦ 


you use the 


fl3'Jf it will 


be shown i ri the t j p p e r 


sc 


half 3ut0JTi3tic 


o 1 1 e V e r r o u ri d 


f if you 5ive t^le c 


c ri 


' ! 'I' it will 


displayed in 


the lower scree orice. 
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! DV will redisplavrf the up^er screen half completely. This 
may be useful if you want to display what is visible for 
instance when a match is lie and e>:tin^ui shes adain. 
Note that all subsequent messages will be displayed above 
the line 'What shall I do?'. You may find this useful in 
some cases f 
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3.2.10 List of ststecients (sorted b« short versions) 



lona version 



short descrir-tion 



lELSE 
! RETURN 
! IF 



!ELSE End IF 

!EN End of Line 

!IF BeSin IF 



?Csrry ?C 

?C3rrs 07 ?C07 

?Carr=j Visible 07 ?CV07 

TExchanse 07 ?£a7 

?F7 ?F7 

?L7 ?L7 

?Not Carrv ?NC 

?Mot Carry 07 ?NC07 
?Nct Carry Visible 07 ?NCVQ: 

?Not Exchange 07 7NEC7 

?Not F7 ?NF7 

?Not L7 ?NL7 

?Not 07 ?NC7 

?Not Visible 07 7NV07 

?Not >♦? ?n:. ♦? 

?07 707 

?Vi5ible 07 7V07 

7*9 7*9 

?>»9 7>*7 



Do I carry anything? 

Do I C2rry 07 7 

Do I carry 07 or 

is 07 visible7 

Has 07 been remo-'ed 

from its startina loc.7 

Is F7 set (=1)7 

Am I at loc. L7'? 

Don't I carry anything'' 

Dori't I carry 07 "i* 

Don't I carry 07 and 

isn't 07 visible"!* 

Is 07 St its 

star tin 3 location 7 

Is F7 reset (=0)7 

Am I not at loc. L7'' 

Doesn't 07 eiiisf 

Isn't 07 visibl97 

the c, 3r. than 9' 
e : < i s t i n 3 s c in e w h . 
visible? 
c. eaual to 9'' 



Isn't 
Is 07 
Is 07 
Is the 
Is the c 



3r 



than 9"!* 
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ICarry 07 
! 'Carr^^ 07 

IDisplay Noun 



!C07 
! 'C07 

!DN 



IDispIa^ Noun and Scroll ! DNS 

IDispla^ Visible !DV 

!Disf>l3-^ * !0* 

!E;<chanse L3 !EL2 

! Exchange 07 and OS !E070S 

lEjcchan^e #3 !E*3 

!Fla^ Dead ! FD 

Inventor*^ l/l 

!Fla3 Uell Done !FUD 

! F7 ! F7 

! ' Inventors ! ' I 

ll'm Dead ! I'D 

Unit 09 !IQ9 

!L7 !L7 

!M7 !H7 
!Not Inventory !N/i 

!Not F7 \HF7 

!Not 07 !N07 

!Over !0 

!07 to LS !07L3 

!07 to 08 10703 

IScrolL !S 

•.'Score !'S 

!Save Game !SG 

IVisible 07 !V07 

!Uait !U 

!♦? !*9 

!+*9 !+*9 

!-»9 !-*9 



Carry 07 without check 
Carry 07 and check 
for max i mum 
Display noun Just 
ente red 

ditto with new line 
Redisplay upper screen 
Display counter value 
E)<chan5e current loc* 
with ' stored loc • ' 
Eicchan^e the current 
locations of 07 and OB* 
E;:chon^e the current c* 
with 'stored counter *3' 
Set Fla^ 'Deod' for 
' ! Over ' 

Set Fla-^ for automatic 

' Inven to ry ' 

Set Fl35 'successful' 

for ' ! Ove r ' 

Set Fl32 7 to 1 

Display 'Carrying**.' 

in the lower screen 

Put to last location. 

Carry Lit Torch (09) 

and start time 

Goto Loc» L7 

Display ^eszace M7 

Reset Fla^ 'Inventory' 

Reset F7 to 0 

Let 07 vanish 

End of ^ame! 

Set 07 to loc» L3 

Set 07 to the curr» 

location of 08» 

Be^in new line 

Score? for 100% = 

' ! Over' 

Save Game etc^ 
Set 07 to current 
location » 
Wait 3PP ♦ 1.2 sec 
Set c# V3l«je to 9» 
Increment c. by ?♦ 
Decrement c. by 9. 
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3.3 E;:smples for A*P.L» pro^ra.ii lines 

S o Hi e e :< s m F 1 e s will show you hew to b e ^ i n p r o ^ r s m m i ri 2 i ri A . F" . L . 
Tl^e eKS.TiFles i^iven are of course simple and are onl-^ (Tieant ©5 s 
starting point* 

Thsre wasn't encusih room iri this refererice Suide to discuss ir» 
depth one complete 3ame with its listing* It is rPca.Ti mended 
L};3t 'jou CONVERT and EDIT one- of the e;;istin:2 aames biou have 
already played in order to understand ^how to do it'» A printer 
will help you doing so! 

3t3»l Conventions for the examples 

The eicsinples of A»r»L. lines cannot of course function 
properly without the pertaining listSf which however have 
I'lct been listed* So if you use 'Message iilO' be sure tc 
h.3ve it defined! This applies to all of the lists 
m e ri t i o fi e d • 

All line numbers or block numbers are er.amples? they will 
have to be changed in your programs. 

If explanations are given behind the statements? DON'T 
enter these texts if you decide to try that line! 

3*3.2 Messages 



3.3.2.1 Messages every rourid 

Let's suppose you want to have a message ever*:^ round 
with 10% probability. Solution! 

CO? 20)- 10!M10 

[RETURN 

If however this message is to be given only if the 
Player is at location L5^ you enter: 
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<0»20)» 10?L5 
! MIO 
! RETURN 

If Mil is to be diven 3t L5 3nd MIO elsewhere* you 
could wrltet 

(0f20)a 10!IF 

?L5 

!M11 

•RETURN 
!ELSE 
!M10 
•RETURN 

If Mil AND MIO are to be displayed at LS and MIO 
elsewhere* you simply skip one statement: 

(0»20)« 10! IF 

?L5 
•Mil 
•ELSE 
•MIO 
•RETURN 

All of these messages will be displayed every round 
with a probability of 107., If you prefer to have a 
message MIO with lOOX probability if the player is at 
LS and 010 is visible (not carried)* you write? 

<0*20)= 100?L5 

?Visible 010 

!MiO 

•RETURN 
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3.3.2.2 Messages displs-^ed at command inF"jt 

It's very common to display messsaes as a reaction tc 
some comm3nd» for instance LOOK. If verb *25 is LOC^.'^ 
you can entert 

(2Zfl)= 0IM15 LOOK : M15 

•RETURN 

Nou let'.s suppose that LOOK WIND is to produce a 
different message. This can be done usins tuo linssi 
<N32 = UIND) 

<25»1)= 32IM1& LOCK WIND: M16 

! RETURN 

<2Sf2)= 0!M15 LOCK : M15 

! RETURN 

Another e v. a m p 1 e for m e s s a £ e 5 will show you how t c r- r •= = 
(ii e 5 3 3 s e s into s e s .ti •? n t s w n i c h can help i ri savins iti ? !Ti o r i . 
Let's suppose that M16 is to be dispia-ed for LjOr '.Ji;;:' 
and different parts of the message shall 
depending on the current location. 

<23» 1 )= 32 ! M16 
! IF 

?L7 at loc.L?: M16+M17/M17 

! m? 

! ELSE 
! IF 

?L3 at Ioc.LB: M16fM12/Ml' 

! M13 
!ELSE 

IScroli besin new line 

! Ml' 

! RETURN else: only MLS/Ml? 



The -3 2 e;{ampl9S have already shown a lot of t". ; 
structure of A . P . L . proarsri lines. Try to thinr- cf 
more complex exarnp les yourself! 
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Ob JSC t -2 /Locations 



Let's suppose ^ou wsnt to achieve 
Whenever the player carries 03f 
3Ppe2Ts together with messssie M10» 
Block *0: 



the following 
it vanishes 
This must be 



result: 
and 010 
done in 



(OflS)= 100?Carr« 08 
!Not 03 
'Visible 010. 
!M10 
! RETURN 



carried? 
vanished! 
010 instead 
Message 



If you want to program the following effect: 
03 'changes to' 010 and 03 disappears to the 
of 010 - this is Quite simple: 



U h e n carried 
old 1 0 c 3 1 i o n 



(Of 13) = 



SOTCarry 03 
! E;:chan^e 
!«10 
•RETURN 



03 and 010 



Now 3 more complex e):3fTiPle: At location L7 - where the 
Player must NOT be at the moment - the objects OlSiQlo and 
017 will turn to a new object 018 with some probability: 



(OflS>- 10!E;cchan^e LO 
!L7 
! IF 

?Visible 015 
?Visible 016 
TVisible 017 
!Not 015 
!Not 016 
!Not 017 
fOlS 
!ELSE 

! Exchange LO 
! RETURN 



Save location 
new location 



Back to 
current 



the 

location 
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Another e:c3iiiple will show 'picking up' objects* If 
instead of a auiet 'autometic' TAKE 3 fnessa^e has tc 02 
displayed when doin^ sof you will have to do so yourself* 
Keep in (nind that the 'reference'-table won't worh. for 
that kind of action! Motet Verb *10 = TAKE 



(10fl)= 33?Visible 024 
! 'Carry 024 

!M33 Message 
! RETURN 

Locations will mainly appear as conditions since most of 
the movement will be done by the 'automatic' GO option. / 

If however you enter GO UIND or something like that ycu 
will have to program that yourself J 



(1^2)= 32?L7 ri5ht location-^ 

TVisible 01? * open window etc^ 
!LS new location! 

IRETURM 

There was an ev<ample in ertchansin^ locations before* but 
it was a side effect in testing for objects. 

You can achieve interesting results by ejtchsn^in:^ 
locations! As an e:: am pie let's imagine a ssirie where seme 
mesic word will move you net to one place? but tc the 
place where you used that word last! 



Let VIS be SAY and HAZ the 'maslic word'. Besidas 03 .ii.jst 
be carried for the effect to take place. 

(lSfl)= 45?Carry 08 

[Exchange LI 

!Me.6 

IRPiTURM 



Remember to initialize the 'stored location' LI for the 
time he uses the ma^ic word for the first ti.Tie' 
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You will have to sive meanings to the different fls^s when 
writing your dsne (if you decide to use them)* For 
instance it is advisable to check for certain coitiple^j 
situations in Block »0 and store the result usina a flas^ 
This simplifies the actions you will tsket 

Let's suppose you want to check for Li7 f nothing carried^ 
and the existance of three objects? 



(0f33)= lOOlNot F6 

?Not Carry 

?Visible 02 
TVisible 07 
?Visible 013 
!F6 

! RETURN 



reset flad 



set fl35 



You can later on use F6 instead cf all the conditions. 
But be cautiousJ Don't alter the situation later on in 
block to without updating F6! 



?F6 
! M2S 
i.Scroll 
!U3it 
! M2? 
IScroll 
! RETURN 



Another important meaning for (one) flaa is 'startup' 



will perhaps have 
'stored locations 
automatically) ♦ So 
once and never reset 



to initialize 'stored counters' and 
(which the command module cannot do 



you use one flai^ (Fl) which ycu set 



(Ofl)= 100?Not Fl 
!Ft 
! *10 

! Exchange *1 
!*40 

!E;:chan:^e *2 
!E>:chand9 LI 
!L3 

lEiichan^le LI 
! RETURN 



Startup 
set 

Numbe r 

stored 
Numbe r 

sto red 
Save curr.loc. 
ri e w 1 o c . 

stored 
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Thera are so mariv possibilities for 3 use of fli^^ thst 
aci^ description uill Isck cofTiPleteness* So this is enc'-ii-h 
for th^t♦ 



3*3tS Counters 



You can use counters for 3 lot of things*. uh9':*"^.er the 
plsyer 'starves' the 'time' 2oes b':^ or p«2rh3P= 'sicu count 
^'.-^-coordinates durins a :^sriet In cll those CEses ^cu 
can't do without counters* 



Store thefn to work with several counters. The 
initializatiofi rrccess has been described before. 

Let's suppose 'jcu want to decrement a counter ('ti.Tie') 
ever'j round arid erid the ^a.-iie wlien it reaches zerot 



(Ot11)= 100 ! E;tchsn^e ^2 
! -*1 
! IF 

?*C 

!Fla5 Deed 
! 0 ve r 
' RETURN 
!EL3E 

!E;:chcn2e t2 
(RETURN 



Get c o u ri t e r 
-1 

= 0^ 

dead 
end 

else 

Save counter 



When usins^ several counters be sure always to ev^chan^e the 

riiSht values so thot stored counters represent onl'=; one 

thin^! This is somewhat difficult when usin3 IF/ELSE 
statements . 



Let's have an exariiPle for an x-v-cco rdinat e calculation. 
Counter *1 = K-value ? Counter *2 = ^-value. Ycu want to 
check for both values bein^ eoual to 30 and then set F9 : 



(Of23)- lOOINot F9 

!E;j change *1 
! IF 

!E:;chan5e *1 
!E;(Chan^e ^2 
! IF 

?550 
! F? 
!EL3T 

IE:- change *2 
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! RETURN 
lELSE 

!E:tch3ri^e *1 
•RETURN 



3*3*6 IF/ELSE 



There have been some eKsmples for IFy^'ELSE cons t rue t i ori« in 
the examples* In those cases no special problerns would 
arise since the IF behaved 'logically' t An example for 
the 'illogical' behaviour of this statement uill follow^ 
NOTE : The followinsl example is WRONG !! (endlsss loop) 

(43fl)= 23!IF <I1> 

?L4 <B1> 

!IF <I2> 
?Carr-f 06 <B2> 
!M65 

!ELSE <E2> 

TCarry <B3> 

lELSE _ <E1> 

?E;-ch3n5e 07 <B4> 
!ri67 
!EN 



Let's see wh.?t happens: If <B1> and <B2> are true? <B3> 
must be true as well (OK»)f if <B4> is true the line is 
executed ' normal lirf ♦ If however <B4> is FALSE execution 
continues at <E1> or <E2> depending on the result of 
<B1>!!! In an^ case this will result in an endlessl:^ 
looping program* 



Now let's have an example for a correct use of this 
special type of IF/ELSE statement* Suppose you want to 
decrement the 'stored counter b*j the value of the 

current counter* This cannot be done with any simple 
statement! Let's suppose that the value of the current 
counter is eoual to or Greater thsn 0 (zero) and that it 
may be destroyed in that subtraction* 
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78 ! IF 

! RETURN 
!ELSE 

!Ej<chsri28 *1 

!E:ich3ri2e tl 
! -*1 

?to 

! RETURN 



current c t r • = 0 : E;: i t 

<E Ill- 
Counter tl 
decrement i 

ditto current counter 
=0? Exit? else :E1>! 



This finishes the short introduction in er.STi^'les for 
A»P»L» program lines* An^^thin^ more detailed uould 
certainly boost this reference Suide to its double vclume* 
You 3re strori3l'=; ericours^^ed to tr*^ and find o«jt '^ourself 
how it works writing examples and anal'fzins existing 

ro-^r ams ♦ Your, success will help "sicu tc learn it! 
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4 HOU TO USE THE 'AD^^EMT'JRE EDITOR' 



A^l General 

The ADVENTURE EDITOR PTOdrsni is written completely in TMS9900 
sssembly code* Two versions e>:ist at the moment: HM-version 
for use with the 'Mini Memory command module' and EA-version for 
use with the 'Editor/Assembler command module'. Both versions 
own the same commands and features so that one reference ^uide 
is valid for both versions* In programming however the 
restrictions for MM were considered^ especially the available 
memory space? so that the EA version uses the available memory 
only to a small decree* 

The program *will support keyboard data entry > screen display and 
file operations with all available peripherals (CassettSf 
Diskettes RS232 etc*) 

4.2 Eauipment 

The programs will ONLY function properly on a TI99/4A and NOT on 
• the old TI99/4 home computer! 

The minimum configuration of your home computer needed for this 
program dep«inds on the program version* In any case however you 
can use all peripherals you want* 

4*2tl MM- (Mini Memory-) version 

The pro-^ras* will be furnished on cassette for this 
version* Therefore you will need the console with the MM 
command module and a suitable cassette recorder at the 
least ^ 

All available standard peripherals . are supported however? 
so that you can make use of diskette files and a printerf 
if you want to* 



Pa^e 42 



Reference Guide 



ad^;enture editor 



The MM pseudo file EXPHEM2 (Memory ejcpansion) is S'jpported 
as well* You can use this file for fast data storage as 
lon^ as you use the MM command modulet This means that 
this Pseudo-file will of course not be available in the 
Adventure command module* > 

4»2*2 EA- (Editor/Assembler-) version 

This prossram version is furnished on diskette stcr^^e 
medium so that you will need the console^ EA cc:Tiaiand 
module^ memory expansion and at least one disk drive* 

Cassette files are supported as well so that Barnes can be 
read. from cassette or stored there if so desired. A 
printer port can be used* 

4,3 Lc^difi^ and starting the prciSram 

The startup procedure depends on the program vers ion ♦ 

4*3*1 Mini-Menory version 

First be sure to have to have your MM initialized ( Option 

3 / Proceed ) Then the program can be loaded from C3=sett3 
usin^ the EASY BUG 'L' option* Note: the available 

memory space in Mini Memory will be used up to the last 
b*:^te so that no other program can be loaded! 

Yq«j can start the EDITOR pro^ra^i by eriterin^ the prc^rsm 

name 'START' when usin3 the 'RUN'-Option of the Mini 
Memory selection list* 

Command proceduret 

* C h o i c e M i n i M e m o r y < 3 ) ♦ 
% Reinitialize (3) * 

* (Proceed) t 
t <Quit> « 

* Choice Easy Bus (2) * 
t (any key) t 
« L « 

* (observe cassette comm a rids) * 

* <Quit:. t 
t Choice Mini Memory (3) * 
t Run (2) * 
^ START t 
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4.3.2 Editor/Assembler version 

The program will be started usirs the 'LOAD AND RUN' 
option of the Editor Assembler. It will be loaded on 
absolute^ addresses usin^ the lower ineiTiory expansion. Be 
sure to have no other program in memory when loading the 
EDITOR* 

You start the program b^d entarins the prc^rom name 
'START' ♦ 

Command procedure? 

t Choice Editor Assembler (2) « 

* Load and Run (3) t 

* DSKl. EDITOR ' « 
t <Enter> * 

* START * . 

4»4 Screen dacription 

When started the standard screen is displaced. A title screen 
or selection list was impassible due to memory space 
limitations* As a program identification the word 'EDITOR' is 
displayed in the status line followed by the revision No . i i.e» 
'- EDITOR— Revl' in this case. 

The screen is divided into TEXT AREA (Lines 1-22) r STATUS LINE 
(Line 23) and ECHO LINE' (Line 24). The screen is 40 
cha r 3C te rs/1 ine f i.e* the prosiram uses te^ct mo.de as does the 
adventure command module. 

The TEXT AREA serves for displaying and editing ^ame data. You 
will be allowed to enter all displayable characters in this 
field. 

The STATUS LINE will display a message from time to time 
indicating pro^rsm status. Whenever keyboard entry is poccibla 
the above mentioned pro^iram ID will be displayed here. 
( ' EDITOR—Revl' ) 
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Th'3 ECHO LINE serves for entering comfiiarids 3nd for echc:':2 
prompts which are error messages at the same time. A con t inuous 
'/I-full' display is siven here as well» - You are NOT allowed 
to enter lowercase letters here since they are converted to 
uppercase as you enter them* This serves for simplifying 
operation by overriding the 'alpha lock' key* 

Keyboard 

Entering te;tt has beenr made comfortable* A blinking 'underline' 
cursor will appear on the screen like in the adventure command 
modul e • 

There is no auto-repeat for any key* so that you have to push 
any key as many times as you want it to er.ecute* 



Upper- and lowercase 

Upper- and lowercase letters and other displayable 
characters have to be entered the same way as in ct'-^.er 
programs* The 'alpha lock' ke*j will disable entering 
lowercase letters* All characters are displayed the sa.Tie 
way as in the 'Adventure' command mcdule? i*e» lowercase 
letters are 'real' lowercaser as soon as you have loaded a 
game* 

The old TI99/4 is NOT able to enter lowercase lettars? ao 
for this reason you will not be able to work with thst 
one * 

As mentioned above entering of lowercase letters is 
allowed only in the tQ:<t area* All inptjt iri the echo lirie 
will be displayed as uppercase. This feature has be = r; 
added for simplifying command input since all command£ and 
filenames are valid only as uprercase words* 
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4.S.2 Function keas 



If you depress <FCTH-> the following keys will hi' 
meanings I 
<FCTN> 1 
<FCTN> 
<FCTN> 
<FCTN> 
<FCTH> 
<FCTN> 
<FCTN> 
<FCTN> 
<FCTN> 
<FCTN> 
<FCTN> 



special 



3 = 
5 = 
S = 



E 
X 
S 
D 



Delete Char 

Insert Mode 

Erase Field 

Besin 

Redo 

Back 

QUIT 

Up arrow 
Down Arrow 
Left arrow 
Ri^ht arrow 



Move to top 

Reexec'jte 

Abort entry 

Caution ! ! ! 

Line up 

Line down 

Char ri^ht (wrap ! ) 

Char left (wrap!.) 



You can leave INSERT mode the same way as you do in BASIC » 



The REDO Key is iiriportant when reexecutind coiiimandSf since 
Just pressing <ENTER> will be interpreted as 'no entry'* 

The BACK key will be used mainly when aborting false 
inputs in the te^t area which otherwise would be stored* 

4,6 Echo lino 

The ECHO LINE (24th line) serves for entering commands and for 
receiving (error-) messages* 



4*6#1- Messages in the Echo Line 



The input prompt Generated by the program serves as error 
message at the same time* Whenever the command executed 
last was successful and without errors? the ' OKt 
prompt is displayed* If however there was some kind of 
error or a warning has to be 3iven it will ch3n:2e to 'x»x 
ER ! ' The letters 'x;:' indicate the type of error that 
occured last* In both esses the next command can now be 
entered * 
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♦ 1.1 


Error mS'sScSes 






The 


letters '>;;;' ui 




h i n the e r r o r - p r o ri p t c s ri have t h 


fcllowins V slues and 


:Ti e s n i n 5 5 I 


i\ )< 


M a 3 n i n a 






CD 


Coriniend Error 




invalid c o m n a n d 


FI 


File Error 




I/O or File error for sames 


PR 


F'pirit Error 




I/O or File error for pririter 








The I/O error will not be 








ar»3lyzed» 


ID 


Td^Tit- Error 




The prosram in memory is 








a) not an adventure 5 a trie 








b) not ^^et converted 


TX 


Te;^t Error 


- 


1 oue rc sse etc ► 


MC 


MeiTiory 0-»'erfl» 




'! V D F* - ) m e fii o r overflow 


10 


Ir;de;c Ov.erfl. 




Mu Tiber too biS or too 








siTtall (indices opjI"^) 


NO 


Nijdieric Overfl 




Number too bis 


SO 


Scree ri Overfl • 




Scree ri Overflow 


SY 


Synts:; Error 




invalid A»P»L» syntax: 


LI 


Line too lon'^ 




A*P*L. line too Ions or 








te^t after last ! RETURN 


LA 


Last line too 




last A»P^L» line too 




lon-^ 




lonS* (converted aciiie onl'=;) 


IF 


IF/ELSE Error 




A.P^L* error in IF/ELSE 








structures 


RT 


Return as suiried 




Uarnin^i: [RETURN assumed 








on sriy level of A»P»L» 



4»£»1«.2 percerit full message 

At the end of the echo line a number is dis?l£'='ed 
before the execution of every comaisnd . This will 
indicate how much of the available (VDP-) mencr--' i£ 
occupied by the ^ame at present* This iiiessa^e will be 
diven only if a (converted) sane has been loade'l* 
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This percentage is deriven from 'available V[ - 

memory space' uhich has been chosen as to enable dsta 
storage on diskette medium, (i.e» up to >3730V). The 
adventure command module houever will accept files 
longer thsn that (up to >3A93V) which will ONLY be 
possible on cassette storage medium with no diskette 
controller connected • 

Motet this can lead to the effect of not bein^ able to 
load future sames with this proi^ram and - by the way 
not from diskette within the adventure command module » 
Games of that kind will however not have been written 
by means of the ADVENTURE EDITOR, All sames presently 
available (12 Barnes) do not ejtceed that size and can be 
loaded and edited. 

Example t 

m EDITOR — Ra^/lt 

% ok: e 95::* 
^ ^ ^ ^ ^ ^ ^ ^ ^ 

93% of the memory occupied ! 

4.5.2 Commands in the echo line 

Commands siven in the echo line may be preceded by blsnx.s 
which will be skipped, Uithin a command blanks are not. 
allowed with the exception of all file comma.nds. 

Commands consist of an uppercase letter and e;:tensions. 

4.6.3 Ending program execution ( Q ) 

In order to end program execution properly enter 'Q', 
This will close any open print file unit. Game data 
stored in VDP memory are lost after execution of this 
commands so be sure sure to have them stored before doin^ 
so! 
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%tttttttt%%ttt*t1tiXt%tttttt*%tt*ttt%ttt%ttt 

# _ EDIT0R--R9V1* 

* ok: Q 95% * 

^ <^ <^ )^ <^ <^ «^ 4^ )^ ^Ic /(c 'jc <^ 4^ <^ <^ <^ <^ >|c <^ /Ic ^^c <^ ^ic ^ '|r 

4#6»4 File coiTiiTjarids 

All file coiTitnands reauire 3 valid filename which msb' be 
the filename of any valid peripheral (see instruction= for 
»rfOijr peripheral ( 3 )) ♦ A blank must be entered follcwin^ 
the command (IfFrP) and preceding the filename (fcr 
instance 'I CSIM 

Uhen usin^ the MM version of this program you can make use 
of the Pseudo-file EXPMEM2 if you have the me.iicry 
e:tPar.sion connected to your home computer. Tni=^ enables 
fast data storage and retrieval as lori:^ as the ^ifl is 
opera tiriSt Be stjre to have stored your Barnes on cassette 
before removing the MM or switching off your computer! 

Uhenevar you use the cassette medium (CSl or C32) the 
usual operatin:3 instructioris will app'^ar arid have to 
f ol lowed ♦ 



If durinsJ a file operation undefined characters will 
appear on t!ie screen this is not fatal as lon^ as they 
disappear at the end of th^it operation. If however ycu 
destroy the character set by loading a BASIC pro2r=m xzr 
instance you will have to restart the EDITOR* 

Hotet Due to an error in the internal file routines it 
iitay come to a system crash when entering invalid file 
names. Uhen this happens all data are lost and dcjr 
computer has to be switched off and on asain. 
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4»6»4fl Losdin^ sdventure Sames ( I ) 



The 'I' cociiTiarid fallowed by a filename will load a ^cfiie 
frofn that peripheral to VDP meaiory^ Any sanie currentlj 
stored there will be destroyed by that operation. 



After loading the Carrie the prc^ratii checks for a 
correctly 'converted' ^ame and returns and 'ID ER ! ' if 
this check fails* If a file or I/O error will occur 
duriniS the loading operation the niessase 'FI ER ! ' will 
be returned. In that case check the same in memory 
- if you want to use it - since it may have been 
(partly ) dest royed # 



Eitamples t 

^ EDITGR--Revl:X 

t ck: I csi * 

« ok: I DSKl •ADVENTURE * 
* ok: I EXPMEM2 

(1) MM with Bieni. expansion only ! ! ! 

4.6»4v2 Storing adventure Barnes ( F ) 

You can store Barnes on any peripheral usin^ the comfTiand 
'F' and a valid filename. 

Any stored (and converted) ^ame may be stored on any 
peripheral. If an 'ID ER ! ' is returned for that 
command the Same was either not yet converted or there 
was no Same at all. A 'FI ER ! ' (File error) indicates 
that something is wronS with the peripheral specified? 
the Same has NOT been stored or chansed in that case. 



Examples t 

:^ EDIT0R--R2V1.K 

* ok: f csi t 

t ok: F D3K1 .ADVENTURE t 

* ok: F EXPMEM2 *(1) 

CI) MM with mem. expansion only ! ! ! 



Pase 



SO 
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4.6»4.3 Qpeninsi 3 printfils ( P ) 

Usiris; the comDsrid ' ? ' with ariv valid filenarrie you will 
OPEN 3 ppintfile on that peripheral* An^ displs-^ 
resulting from a conifTiand (see below) will then be 

directed to that file in parallel to screen output* 
This will continue until you close that file unit. 

The file is opened as a SEQUENT I AL ; D I SPLAY f VAR I ABLE 
80?0UTPUT file* The first 40 characters of any one 
line will be used however for te^^t output* - You sr-j 
NOT allowed to specify CS1/CS2 or EXPMEM2 as a P;-int 



After openinij this file unit the ha£^ier 
'•Processed by UEIAMD ADVENTURE EDITOR-' will be 



The •S'rint file unit will be CLOSEd in one of the 
fcl lowing cases t 

a) List rile Error ( 'PR ER!' ) 
b ) ' I ' or ' F ' - c 0 in tTi a n d e v e ri if 

this will r e s I J 1 1 in an error, 
c ) ' Ct ' c o ai m 3 n d - but NOT when 

<FCTM>= (Quit) key is used !!! 
This means that you can issue the co.iiciand 'P CL2.SE' 
which will result in a "PR ER!' but will clo«e th^ 
p r i i-i t file unit. 

E ; : a m p 1 e s r 

t EDITQR--Revl^. 

t ok: P RS232.BA=600 » 
* ok: P DSK2. AD';-LIST * 
« ok: P CLOSE t (3) 

(3) will result in a PR ER ! 

thus closing the file unit. 
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A. 6 



D s t o fTi s n i r- u 1 o t i o ri 



There are conitriands for esch list b'ou csn access. These 
uill have to be modified depending cn the acticriB '^ou w£nt 
to take* 

4»6*S»lListselectiori 

The dsta .Tianipul ation coirimands are sinslle capital 
letter conifTisnds derived froiri the list natTie:** 

- Messages < M ) 

- Objects ( 0 ) 

- Locations ( L ) 

- Verbs ( V ) 

- Notjns ( N ) 

- References ( R ) 

- Situation ( 3 ) 
-Connections(C) 

- A.P.L. C A ) 

- Gerieral Information ( G ) 
-Entrvscreen(E) 

4*6»S.2 fJsin^ indice'5 

Directl'j following the letter '^ou will ^enerall':^ have 
to specif':^ one or two parafiiete rs . Two numbers hava to 
be separated usin^ a com ma 



The conmands 'E' (Entrv screen) and 'G' (Ganersl 
Information) need no parameter at all. 

Examples t 



- Edit A .P .L. 

- Edit other lists 



Blocktf Lmet 
E 1 e m e ri t * 

Block* ( from ) f 3lGckt ( to ) 

£ 1 e (Ti e n t * ( f r o ni ) ? E 1 a n e ri t * ( t o ) 



- Displa*:^ A»P.L» 

- Display other lists 




« ok: IOOtIOO 707.*(3) 
* ok: lOflOO 70X^(6) 

(S) end (6) are identical ! 
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4»6.3,3 Adding alenisnts tD li = ts C I ) 

A leading 'S'-si^n sllows adding elements to the list 
specified by the commsnd letter. This can be done in 
lists Mf Of Lf Vr N and A, 

Ariy new elemerit will be giveri the defaOlt value? i.e» 
for te:(t lists and lOO'RETURN for .?n A.P.L. line. 
This will have to be changed to the desired value at 
once or later on* 

Adding elements is generall's? possible only AT THE E.MD 
OF THE LIST ! ! ! This means that specif'^ing a parameter 
is not necessary-. Keep this in mindJ It is NOT 
POSSIBLE to insert new elements within the lists!! 

A ri exception f r c ai this occurs in editing A ♦ F' • L ♦ 
programs sirice it is possible (arid necessar-z^) to iriser^ 
lines between e^istin-:^ lines* If you speci-f-ri 5 pair o*^ 
TMjmbers here the riew lirie will be iri seated BEFORE the 
lirie specified* A riuiriber zero or no riuiiiber at all will 
add the new line to the end of that bloc'r. • 

E;iaiTiPlest 

EDITOR--Revl:ic 

70Xt- ( 4 ) 

7o::t ( 5 ) 

(4) arid (3) are identical ! 



* — 






X 


ok: 




% 


ok: 


IQ 


% 


ok: 


SAl »2 


% 


OK : 


SAO f 0 


t 


ok: 


SA 
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4»6*5»4 Deleting elefrientrs 

Deleting eleinents from the lists is achieved by 
returning an 'empty' text area for that element (not by 
altering the comoiand)* 

This is possible for the lists specified above? only 
ArP»Lt lines can really be deleted (purged) f whereas 
other list elements will be replaced by the default 
value The reason for this is that pursins list 

elements would result in the necessity to rewrite all 
of the A»P.L» program! 

4*6#6 Displaying tejtt < ! ) 

The commands described above will call one elefiient and 
display it in the te>:t area so that it can be editad. 

If however you want to have the elements displayed you can 
specify the '{'-character in the first placet In that 
case the- element will only be displayed? it can't be 
edited^ If a print file unit has been opened output will 
be directed to that peripheral :n parallel* 

If ""you specify more than one parameter the corresponding 
list elements will be displayed one by one automatically* 
This will help you findin::* a special list element and also 
pr intiri^ parts or all of the ^ame contents* 

If durinsi this display process you press any one key 
(except <BACK>) the automatic display will stop and wait 
for another key so that you can have a look at the current 

element displayed* The message ' Waiting is 

displayed at that time* If the ne:<t key is <BACK;. r the 
display process is aborted while any other key will 
continue the auick search* 

Nctet If 3 print file has been opened the keyboard is 
scanned only after printing out one screen completely^ 
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If you specify A ♦ F' . L ♦ to be d i s p 1 a 9 d the ri « j .ti c e 5 
follow ins the both indicste blocks of A . P . L • 

lines? i#e« you csn't specify single lines m this ftiode. 
The display however will show the cj^rent block 2nd lire 
number &s it does in edit mode» 

If durin:2 dis?^l3v of sny A^P.L. line it won't fit cn ere 
screen the first screen is displayed (lon^ versions of 
A.P^Lt codimands) end printed if s print file hss been 
o:--enedf then the ne^b screen will continije thst line snd 
3 0 0 ri . In that case the b 1 o C k / 1 i ri e n u n b e r s h o w ri i ri the 
upper left corner will be followed by the plus si^n 
in pJsce of the usual si^n to indicate that the rest 

follows on the ne:tt screen. 



E;t SfTiP lest 



t 


ok: . 


! M 1 0 


70%* 


t 


ok: 


! MO » 100 


7o::* •; 2) 


t 


ok: 


! M > 100 


70%* (3) 


t 


ok: 


! A2 


70%* ( 4 ) 


t 


ok: 


!A»100 


70%*(;) 



(-2) arid (3) are identical ! 

(4) displays block *2 (all lines) 

(3) displays blocks *0 through 100 

4.7 Editing text 

E d i t i n 1^ text data in 
element has been called 
mode ) • 

In the upper left corner the eleaient number is shown followed by 
the eaual (' = ') sisn if the eleirient has been found • 

If the element specified has been fourid the cu-^sor will Tiove to 
the first screen position within tlie te^ct ares* You can a-:: it 
the te:tl data as you like* Pressing <EMTER> or •■REDO; will 
store the current display wh^ireas ^'SACK!: will abort data antr-:^. 
This is important if you changed the values in some wa-:^ and 
don't want them to be storad like tli."^t. 



r'ne te^tt area is possible only if the 
' r Q m edit mode ( r; o t d i s p 1 a y / g u i c k-. a a £ r c h 
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Uhenever you ENTERered 3 screen the program checks for vslidit*^. 
If no error is found the results are stored. This happens word 
word or (in A«P*L») coniBiand comnidnd so that ^our dsta (iia^ 
be truncated if an error is found! 

The message ' — -Working will be displaced in the mode line 

when this 'checking and storing' process is active* Note: It 
Day take some time till the process is finished especiall^f when 
entering lon^ lines and/or when iiemory is fillin:3! 

4.7.1 Messages ( M ) 

Messages are text elements used from within the A.F'.L. 
You can enter this text freely. Uhen redisplayed all 
ittultiple blanks are removed and replaccc by single blank 
s isins . 

The m3;:imum word lensith is 32 characters. The total 
length of one messasle is only limitod by the adventure 
display. Note* Specifying messar^es which - when 
displayed on one adventure screen at a time - will prod^jce 
3 screen overflow may cause a systeni crash within the 
adventure command module! 

Uhen displayed by the adventure command module words are 
never urappe<i around the end of a line? a new line is 
be^un instead^- This will NOT happen within the ADVENTURE 
EDITOR where you can write words wrapping! around the 
screen border. Have in mind the effect that display will 
look different during the ^ame. 

E>t3mple I 



*(10)= This is a sample message t 

t t 

t t 

t t 

t « 

* t 
t EDITOR — Revl* 

* ok: MlO 707.t 



<^ <^ <^ )^ <^ <jc <^ <^ /ft /^c <^ <^ ^jfi <^ }^ <^ ^ >^ }^ <^ /{c 
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A. 7. 2 Objects ( 0 ) 

The te::ts for objects sre entered the same uisi 
described for messages* RemefTiber that cbwects cii.ir.r, .-i.: 
with the asterisk are 'treasures'' 

4»7»3 Location-^ ( L ) 

The te:tts for locations are entered the sairie as 

described for rnessases. Have in triind that locsticn^ 

beginning with an asterisk ('t') will not be preceded b'i 

'I'fti in a when displa's^ed during the sairte! 

A. 7. A Verbs ( V ) 

The method for enter iniS verbs is the same as ente^^in^ 
other teicts* The^* ma= however onl^ be made out c: 
uppercase letters. Usin^ lowercase results in a 'TX EF: ' ' . 
The lensith of an^* verb must be less than or eaual tc tn-? 
lerit^th of 'abbreviations' specified within the 'ser. 373! 
information' (see below; » This covers NOT the ast^risi^ 
(">') which indicates that tliis verb is a s'^non^m for the 
p reccdin:2 one ♦ . • 

4 •7,5 Nouni C N ) 

Nouns are entered exactl^:^ like verbs# 

A. 7. 6 References ( R ) 

R e f e r e ft c e s c a ri be 5 i v n for 3 ri '=i 0 b J e c t ? i . a » the 

parameter :2 1 •/ n is the ri u m b e r of an object. C o n s e a u e r. 1 1 j 

the n u III b e r displayed in the t e t a r e z is a rj o u r« u b e r 

(N.»)» If 'rjou enter 'NO' this will mesnt there is nc 
r f e r e f; c e to T A K E / D R 0 F' this o b wi e c t - 

E;camp 1 e t 

tttt 1 1 m :r t ^ 'X t % % X X -ftx X % X X X X. X % '4. X X x. x xxx x. x v x x x x 

.t(10)= HZ X 

.« * 

t * 

* * 

« t 

X. t 

t EDITGR--F:evll: 

:4c ok: RIO 70':x 
tXXtXXXXXXXX X tXXX X t X X X XXXX X X xxx X X X r X X ^.XXX ■¥. 
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4,7,7 Situstion ( S ) 



The situations are as well aiven for objects so that the 
parameter of this command is the number of an object S3 
well. The screen will disF-laa the number of a location 
(L..). If aou enter 'LO' this meanst the object doesn't 



exist (at the moment)? 
exactly that. 



If 



'iOU 



enter 'Carry 



it 



oie ans 



EMampl e t 

«(7a)= Carry « 



t 
t 
t 
t 

* 



ok: S78 



t 
t 
t 
t 
* 

•editor — Revl* 
707.% 



4.7,3 Connections ( C ) 



You enter connections between locations so that the 
parameter of this command is a location number. The 
results displayed are the location numbers of the si:: 
other location which can be reached by enterina a. 
direction command. If you 
positions this means that 
di rection. 



enter 'LO' in one of the 
there is no e:;it in this 



E;{3mple : 

ttt*ttxtttttttttttttzt%-ttt*tttiiit*tttxxtttt 

«(14)= LO 



« 
* 

* 
* 
t 

t 



LI 

LO 

L3 

Lll 

LO 



ok: C14 



*(2) 
«(3) 
«(4) 
«<5) 

* 

•EDIT0R--Revl* 
70%* 



t.*«*X****«t t ********* 



(1) 
(2) 
(3) 
(4-j 

(6) 



North 
South 
East 
;Uest 
Up 

Down 



No connection 
Lccotiori *1 
No connection 
Location *3 
Location tH 
No connection 
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4.7.9 A.P.L. 



( A ) 



The asms structure hss to he entered usina the '^rosrari 
IsnSusse' A.P.L. which hss been describ'Sd in th^ ls=t 
chapter. In order to know an A.P.L. cotiimsnd the EIi'TCF; 
reauires only the UF-Psrcsse letters > nuirierics snd the 
characters V' f "?•»• f >'>•»•' ' if they belong to thst 



commsnd. Lowercase letters and blanks 
'decorative' purposes snd clarity only. 



re 



The display is 'structured' if possible? i.e. !Ir/!EL3E 
levels are suitably indented. This is however only done 
to iTjake structures claar snd can be altered or cohip 1 e t e 1 'j 
forjiotten when entering data. 



If the 



•» i r, 



me 



is longer than one screen it will be 
redisplayed usin3 the 'short coTimsnd versions' and without 
ind'^ntinil. This .uakes the line scinewhst hard to read but 
it enables editin:2 and reenterinii. Structured dis^lsy insy 
later be achieved usin^ the '!' option. 



The first number shown is the line 'header' 
edited but not deleted. 



It 



si3y 



O 9 



Er.asjpl e t 

«$-;::^:t***t*t.1f«i::<tt*tt ********* 



*( 1 f 5) = 

t 

« 

* 
t 
t 

t 

t 



20TL3 
TCarry 
!M33 
! IF 
?F7 
! M34 
lELSE 
! RETURN 



01' 



•EDI' 



ok: ai> 



« 
t 
t 
« 

t 
« 
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4»7#10 General information ( G ) 

Several numeric data are fathered here which are preceded 
by the si^n for that reason* - This command has no 

parameter* 



(1) Number of objects to C3rry=6 

<2) Starting location = LI 

(3) Ma>t* number of treasures^lO 

<4) Length of nouns/verbs =3 

(S) 0 >i 2S6 + 

<6) 1 K 100 = 100 Steps for Torch 

(7) 'Score'-Loc3tion= L15 



4%7*11 Entry Screen ( E ) 

This command has no parameter* 

The so-cslied entry screen uill be shown once when the 
^ame is started* It can be edited here* The tertt should 
be written in a way as to identify the same for the fut'jre 
player * 



Thcf last two lines of the entry screen are 'Copyri:2ht' 
lines for the ADVENTURE EDITOR and can't be altered. 



Example ! 




(1) 
(2) 
(3) 
(4) 
(5) 
(6) 
(7) 
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3 HOU TO USE 'ADVENTURE CONVERSION' 



j*l General 

The ADVENTURE CONVERSION program is ver^ similar to the EDITOR 
program as to its OFeration* It will however be used Gnl=; 
rarel'riJ i.e» oril*i wheri yoij warit to edit e;:ist:ri2 ^smes which 
were not written with the ADVENTURE EDITOR* 

Uhy do you need a special program for that purpose'^ Well? the 
games available from Texas Instruments contain all the texts and 
lists needed to pla*:< the game? but some internal data neede for 
the editor are missing or given inconsistent 1"^ ♦ The CONVERT 
program will generate or update this information from the 
existing lists and store them invisibi'd with the game* This 
means that a conversion process is needed onlv once for an^" one 
game* It will however riot do ari^ harni to a g3r:e if 
'convert' it seve r a 1 . t imes b'.-^ accident* 

Especially the game conterits will not be altered* There a^e two 
minor exceptions to this rulet A* The Entr^^ screen will be 
changed b*:^ adding the copyright lines* 5* Due to a false 
number of 'objects' given in some of the available games it will 
be impossible to load pre v'ious 'game situations' ('SAVE GAME') 
after conversion? since this number has to be updsted the 
CONVERT program. 

5 . 2 E Q u i p m e fi t 

All of t'ne remaT^ks for the EDITOR progrsm sppI'^^ to hD'.'EN.T'J -.E 
CONVERSION as well * 

S*3 Loadirig arid starting the progrsni 

The startup procedure is the same as for the EDITOR with th3 
exception of the diskette filename which is ' D3K 1 . CON'.'EriT ' or 
the second program on cassette side A? r espec t i ve 1 * 
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5*4 Screen; Keyboard and Echo line 

All of this is same as for the EDITOR with the er.ception of the 
r- po^rara ID diven in the mode line which is ' CONyERT-Revl ' • 

Error messages ';<x ER ! ' are the same but restricted to the 
following types I 





Meaning 




CD 


Command Error 


- invalid command 


FI 


File Error 


- I/O or File error for games 


PR 


Print Error 


- I/O or File error for printer 






The I/O error will not be 






analyzed » 


ID 


Ident Error 


- The program in memory is 






a) not an adventure game 






b) not yet converted 



S»S Ending program execution ( Q ) 

In order to end program ertecution properly enter 'Q'» This will 
close any open print file unit* Game data stored in VDP (T.erTiory 
are lost after e>',ecution of this commandf so be sure sure to 
have them stored before doing so! 

Example t 

t CONVERT-RevDIt 

* ok: Q 95% t 

3»6 File commands 

File commands are the same for CONVERT as for the EDITOR* 



Ps ^e 
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i 3 .Ti 8 3 

When losdin^ d Same ('I') the 'JDR merrjorv will be cleared 
first* This tskes some tikiie lo that the T^iss^sa 
'Uorkin2».#' will he shewn in the mode line* This results 
in destro^in^ sn'sj 53(Tie in (uecior'd even if no leading takes 
?-l3ce due to 3 'FI ER ! ' ♦ 

Keep in mind that you can 'load' ('I') an-a! prosra.Ti file 
(i»e* 3ny Same even if not -siet conver^ed) but that a 
'S3ve' operation ('F') will onl*^ work for converted sames 
since the ^atne len:2th is deterfrtined during conversion. If 
"dou tr*^ to save a same which is not '^et converted an 'ID 
ERl'willbereturned. 

Have in mind the possibility^ of usin^ the pseudo-fila 
EXFt-^EMZ when workinsi with the ^IM pro^ratii version 5n:j 
having ^* o u r m e ni o r ^ e p a ri s i o ri c o r. ft a c t a d . ' This e ri = b 1 a s fast 
d a t € s t o r a £: e for h a n d i n over :i a a s t c the EDITOR. 

Er.aniples t 

in ; CQNVERT-Revl.lc 

t ok: I csi t 

* ok: I D3K1 .ADVENTURE t 
t t 

t ok: f csi t 

t CK: F DSK2 . ADVENTUREl t 
t ok: F EXPMEM2 1) 

(1) ONLY MM with iriemory ans i on ! 

5*6.2 Openinsi a printfile ( P ) 

You can open a print file unit the ^aaie wa'^ as ^^ou c'c it 
in the EDITOR proaram^ This print file will houeve^ zr.l^ 
print 'statistics' if '^ou ariter the cofriciarjd to do so. 

E:c3(TiP 1 as J 

t CGNVERT-Rev 1 X 

•« ok: P RS232.EA = 600 t 
t ok: P DSK2. adv-list t 

* ok: r close t (3) 

% 1 1 1 1 1 4: 1 1 1 X t if. % .t t Jf. * X 1 1 'M t X'XXttJi^.Xtt:t X X t X t X X 

C 3 ) will r a s I J 1 I in a F' R E ?: ! 

th»is closing the file unit. 
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.7 CDintnsnd 'GC' 

G or GO will £t3rt the conversion process* This will work onl'f 
if you have 'loaded' an adventure statiiGf otherwise an 'ID ER ! ' 
will be returned* 

The message 'Working* will appear in the mode line to:3ether 
with sodte numbers indicating the actual program step. These 
numbers have no special meaninji to youJ they Just show that the 
program is still working* After completion the messs:2e 
'Processed by Ueiand Adventure Editor' will appear in the first 
lines of the text area* 

:?e:K Processed by UEIAND ADVENTURE EDITOR 4cic 
«(c^M. Ueiand Feld55artenstr . SO D5 Koln 60 t 
« « 
« « 
t * 
t t 
t t 

* CONVERT-Revl:|c 

« ok: G 70-/:t 
t%ttt%tt*ttt1littttt*tt1littttttttttt^ 
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S • S C o .11 ;Ti 3 ri d ' 3 1 3 1 i s t i c s ' 

Enterins 3 will result in displs^in^ seme useful inf o rajst i on on 
the 23:Tie in ffiefnor^ which must be s converted one. These or:^ 
clear enough so that the^ have not to commented here. You can 
make use of these data when printing or displs^ins an overall 
documentation of a 5ame since you will set to know hou msn^^ 
items there are in any one list* 

!S will print the scree ri ori a pririt file uriit in parallel to the 
display if the 'P' command has been issued before. 

tt Processed by UEIAND ADVENTURE EDITOR t.'.r 
«(c)M.Ueic:nd Fe 1 dsa rt enst r • 50 D3 Koln 60 t 



t * 

t Number of Messages : 0 t 

t Number of Objects : 10 t 

* Number of Verbs : 20 t 

» Nu.nber of Nouns t 20 t 

t Number of Locations : 2 t 

t YoucancarryiobJects t 

*. Startin^Locatiorill t 

t Number of Treasures I 0 t 

t Location for Treasures J 1 t 

t Len-:3th of Nouns/Verbs : 4 t 

t t 

t Bytes occupied : 2312 of 13134 t 

t t 

m C0NVERT-Revl4: 

t ok: !s 19::^ 



>^ <^ )^ )^ *^ ^ *^ 
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EMPTY 'ADVENTURE TEMPLATE' F3r YGUR OUN ADVENTURE GAMES 

Together with the EDITOR yo»j received s file named TEMPLATE which iz 
designed to enable writing saines 'frotri the start' ♦ A short 
decription follows^ 

The lists shown below are the same as generated by the EDITOR 
program when printed out? so this is an example for the documenation 
^:^uu will be able to have when using the EDITORt 

G»l Wh*rf you should use the 'template' 

A template will offer to the EDITOR program the basic structures 
it needs for generating an adventure game* This 'template' 
structure had to be 'hand-made' using a debugger and stored for 
yoijr convenience* I,t is necessary to use the template since you 
cannot delete list elements from existing games with the EDITOR » 

Furthermore the pre-defined values and some more information 
needed for any adventure game have been inserted as a start to 
your work* 

6*2 What you can do with the 'template' 

You can expand the lists given in the 'template' in any way you 
like* You, can even alter the information stored in it if you 
like sof but be aware of what is pre-defined in the adventure 
command module (see the chapter 'Structure of an adventure game' 
if in doubt ) ♦ 

6*3 Loading, the TEMPLATE 



6*3*1 Mini-Memory version 

If you own the MM ( Mini -Memo ry ) version the TEMPLATE file 
will be on cassette medium like the programs* 

So you start the EDITOR program as usual and enter the 
command 'I CSl'* The file is located on cassette (^"^^^ 
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6»3»2 Editor-AssefTibler version 

Usin^ the EA (Editor Asseiiibler) version the TEMPLATE file 

is locsted on the diskette tcsatner with the f^rc^rs.Tis 
EDITOR and CONVERT* 

So after the standard startup procedure for the EDITCF: ^'cu 

enter the coinmand 'I DSK 1 ♦ TEMPLATE ' . Uhen savins it 

change vour diskettes since the one you «2ot is write 
protected ! 

6*4 TEMPLATE Contents 

Uhen executing the 'Statistics' coaiinand froin within the CONVERT 
pro^raoi and having the TEMPLATE loaded before you will receive 
the following results (display/printout) t 

Number of Messages I 0 
Nu:nbc-r of Objects t 10 
Number cf Verbs t 20 
Nufiiber of Nouns t 20 
Nuiriber of Locations I 2 
You can carry 6 Objects 
Starting Location t 1 
Nuf;»ber of Treasures t 0 
Location fo?* Treasures I 1 
L^n^th Nouns/Verbs : 4 

Bytes occupied 
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The following printouts csn all be sene'^atpd usin^ the EDITOR by 
issuing the commands printed out on top of a^-zh list: 

6»4.1 Entr^ Screen ( E > 



EDITOR—Revl 

ok: !E 19% 
* M*rf own Adventure '1^ 



You may construct *rfour own ADVENTURE 
GAME with this template^ You will have 
to add: -L-ocations 

-0-bJects 

-V-erbs 

-N-ouns 

-M-essa^es 

-C-onnect ions 

-S-ituations 

-R-eferences 

-E-ntry screen 

-G-ene r al Info rmat ion 
and-A-dventu re Program Statements 

Read carefully the instructions for 
the ADVENTURE EDITOR program! 



now press ENTER^t 
6*4^2 General Information < G ) 



ok; 

(0) = 



!G 



*6 
#1 

to 

«4 

»0 

»100 



•EDITOR — Revl 
19% 
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6.4.3 Hes532e3 ( h ) 

£DITQR--?;cvl 

ck: !Mfio 1?:: 

.£.4.4 Verbs ( ) 

EDITOR — Revl 

ok: !v,20 19:: 



(0) = 




( 1) = 


GO 


<2) = 


tUALK 


C3) = 




<4) = 




( 3 )'= 


? 


(6) = 




(7) = 


7 


<8) = 


SAVE 


<?) = 


QUIT 


(10) = 


TAKE 


(11) = 


*GET 


(12) = 


*PICK 


(13) = 


? 


(14) = 


7 


(15) = 


7 


( 16 ) = 


7 


(17; = 


7 


(13) = 


DROP 


( 1?) = 


«GIVE 


(20) = 


7 



OK : 


! N. 20 


(0) = 


7 


( 1 ) = 


NORT 


(2) = 


SOUT 


(3) = 


EAST 


( 4 ) = 


WEST 


(3) = 


UP 


(6) = 


DOWN 


(7) = 


GAME 


(£) = 


7 


(?) = 


7 


(10) = 


7 


( 1 i ) = 


7 


( 12 ) = 


7 


( 13 ) = 


7 
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(14)= ? 

<15)= ? 

(16) = ? 

(17) = INVE 
(13)= ? 

(19) = ? 

(20) = ? 

6,4.6 Objects ( 0 ) 



(10)= ? 
6.4.7 References ( R ) 



ok: !0>io 



EDITOR— Revl 
1?7. 



(0) = 

(1) s 

(2) = 

(3) = 

(4) = 

(5) = 
(6 ) = 
(7) = 
(3) = 
(9) = 




torch 



OKt !Rfl0 



EDIT0R--R9V1 
19/: 



(0) = 

(1) = 

(2) = 

(3) = 

(4) = 

(5) = 

(6) = 

(7) = 
(3) = 

(9) = 

(10) = 



NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
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6.4 ,S 



Situation ( S 


OK : 


! S » 1 0 


(0) = 


LO 


( 1 ) = 


LO 


(2) = 


LO 


(3) = 


LO 


(4) = 


LO 


(5) = 


LO 


(a) = 


LO 


(7) = 


LO 


(3) = 


LO 


(9) = 


LO 


<10)* 


LO 



■EIiITQR--R9vl 

1?:: 



6.4.9 Locations ( L ) 



OK 
(0) = 
< 1 ) = 
(2) = 



! Lf 10 
? 
? 

7 



•EIiITGR--Revl 

I?:-: 



6.4,10 Connections ( C ) 



OK 



(0) = 



(1) = 



(2) = 



! C> 10 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
LO 
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6.4,11 A,P,L» ( A ) 

EDITOR — Revl 

ok: !A»20 19% 
(0»1)= lOO'RETURN 
Ofl)= 7!S3v<3 Gsne 

•RETURN 
<9rl)= OlOver 

! RETURN 
(10»1)= 17! ' Inventop*^ 
! RETURN 
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7 ADDITICNA. I-.-.j'.MATION 



7»1 On the history, qt aDUENTURE EDITOR and ADVENTURE CONVERSION 

The program F'Sckase ADVENTURE EDITOR results frcai days (and 

nishts) of 3 private computer hobby. There was no backup front 

Te^ias Instruments or Adventure International so the author asks 
o u for s o ni e ij ri d e r s t a ri d i n ;5 ♦ 

As an^ TI99/4A owner who is iriterested iri the 'iriternals' of his 

home computer will know the command modules available will 

result in an 'easy-to-use' program startup but are likely to 

lock the internals to anuone who wants to 5o a little deejs'er* 

This is valid for the adventure command module 'as well *. You 
can "only buy the command module and the available s=;rT;e£;- 
writiri^ or editiri^ theni is simply impossible. 

- yh-.:?n - hunting 1*0 r all bits of information - you open zhs 
ccmm<5rid module (you' did itj i know...) ycu will see a little 
ciiip which will seem curious at the first look and even at th^^ 
secondorie# 

U^^ll!• this is one of the in^eriious GROMs (Graphic ROMs) used so 
often by TI. It has the incredible advantage of net bein:^ 
available and thus not bein^ i n t e r es t i nt:^ for 'pirates'. GROris 
are by the way 'byte orierited serial ROMs' which t. al-'^i 
replacement by other chips impossible. 

The content of this little 'proi^ram safe' can be read from 
within mc;chine lani^uaSe - but the ner.t problem is arisi.':si scent 
'4ii3t the hell is that!? No machine lansiuase? no BASIC; rut 
te:;ts 'embedded in curious bytes ... 

You have Just come across the famous G F' L (Graphics ^ r o s r a m m i -i 
lan^uaiie) which is the 'native lan^ua^e' of your TI99/4' For 
some very understandable reasons TI is not willin:^ to hand cut 

' t ,'=' 5 ^ c 9 t ' . 
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So the only way to set slons wss to nave a - very - close look 
c.l Ihe internal ROM on addresses >0000 throush >2000 which 
contains awon:^ other parts of the system the GPL interpreter^ 
AnBlyzin:^ that part of the system ROM hclred to understand how 
GPL is structured and to Set to know most of its commands^ By 
the way GPL has nothing to do with graphics! It misht be 
interesting to know why it was called so in order to understand 
what TI had in mind when planning the TI99/4 

GPL is a very interesting language with several very mighty 
addressing modes* It is Quite well suited for writing comple:t 
iprcgrams requiring relatively few amounts of memory spacer 
especially when making use of VDP? GROMs and RAM/ROM in turn. 
One great disadvantage is known to all those who have compared 
GPL <comm3nd modules) to pure assembly language I It is 
comparatively slow due to the interpreter overhead* 

Thiere csn be no discussion of GPL here which would be of no use 
to most of the readers* 

Anywayt with that GPL stuff in mind an analysis of the adventure 
command module GRCM was an easy thing* 

A new type of structure came into view: the adventure game. 
Finally it was possible to write an assembly language program to 
edit adventure games and to write your own ones* 

A special problem arouse in finding a name and command 
desc r i:*tions for the internal 'program language': It was called 
'A*?*L- = Adventure Programming Language' f and the comciond 
names seem to be suitable for fast data entry and readable 
display as well* 

As you can see from all that there is a lot of work hidden 
behind the surface of the AD^^ENTURE EDITOR. But a new type of 
program has been born - one that makes use of the 'progrsm 
safes' named command modules* This may seem simple to the uier? 
but it is really the result of many a night spent by a computer 
f reak * 
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